# internaldeveloperplatform/public-site architecture

> Architecture diagram of the GitHub repository internaldeveloperplatform/public-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/internaldeveloperplatform/public-site
- Repository: https://github.com/internaldeveloperplatform/public-site

## Overview

This repository is the source for the public Internal Developer Platform community site. The documented workflow is that contributors change Markdown content, which Hugo uses to generate a static site. The content is organized into learning guides, ecosystem listings, and community resources. No source excerpts were provided, so the graph shows only relationships documented in the README; it does not infer how Hugo templates or deployment work.

Main entry points: [`content/learn/core-components`](https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn/core-components) (Core Components), [`content/learn`](https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn) (IDP Guides), [`content/ecosystem`](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem) (Ecosystem Overview), [`content/ecosystem/paas-devops-platforms`](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/paas-devops-platforms) (Platform Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning Guides"]
  node_learning_core["Core Components"]
  node_learning_guides["IDP Guides"]
end

subgraph group_ecosystem["Ecosystem Directory"]
  node_ecosystem_index["Ecosystem Overview"]
  node_paas["Platform Services"]
  node_tooling["Platform Tooling"]
  node_developer_portals["Developer Portals"]
  node_kubernetes["Kubernetes"]
  node_monitoring["Monitoring"]
end

subgraph group_community["Community Resources"]
  node_community_index["Community Overview"]
  node_consultancies["Consultancies"]
  node_experts["Experts"]
  node_community_events["Events<br/>[events.md]"]
  node_community_articles["Articles And Books<br/>[articles.md]"]
  node_war_stories["War Stories<br/>[war-stories.md]"]
end

node_contributor(("Contributor"))
node_hugo["Hugo Generator"]
node_public_site["Public Static Site"]

node_contributor -->|"contributes content"| node_learning_core
node_contributor -->|"contributes content"| node_learning_guides
node_contributor -->|"contributes content"| node_ecosystem_index
node_contributor -->|"contributes content"| node_paas
node_contributor -->|"contributes content"| node_tooling
node_contributor -->|"contributes content"| node_developer_portals
node_contributor -->|"contributes content"| node_kubernetes
node_contributor -->|"contributes content"| node_monitoring
node_contributor -->|"contributes content"| node_community_index
node_contributor -->|"contributes content"| node_consultancies
node_contributor -->|"contributes content"| node_experts
node_contributor -->|"contributes content"| node_community_events
node_contributor -->|"contributes content"| node_community_articles
node_contributor -->|"contributes content"| node_war_stories
node_learning_core -->|"generates from Markdown"| node_hugo
node_learning_guides -->|"generates from Markdown"| node_hugo
node_ecosystem_index -->|"generates from Markdown"| node_hugo
node_paas -->|"generates from Markdown"| node_hugo
node_tooling -->|"generates from Markdown"| node_hugo
node_developer_portals -->|"generates from Markdown"| node_hugo
node_kubernetes -->|"generates from Markdown"| node_hugo
node_monitoring -->|"generates from Markdown"| node_hugo
node_community_index -->|"generates from Markdown"| node_hugo
node_consultancies -->|"generates from Markdown"| node_hugo
node_experts -->|"generates from Markdown"| node_hugo
node_community_events -->|"generates from Markdown"| node_hugo
node_community_articles -->|"generates from Markdown"| node_hugo
node_war_stories -->|"generates from Markdown"| node_hugo
node_hugo -->|"generates site"| node_public_site

click node_learning_core "https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn/core-components"
click node_learning_guides "https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn"
click node_ecosystem_index "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem"
click node_paas "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/paas-devops-platforms"
click node_tooling "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling"
click node_developer_portals "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/developer-portals"
click node_kubernetes "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/kubernetes"
click node_monitoring "https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/monitoring"
click node_community_index "https://github.com/internaldeveloperplatform/public-site/tree/main/content/community"
click node_consultancies "https://github.com/internaldeveloperplatform/public-site/tree/main/content/community/consultancies"
click node_experts "https://github.com/internaldeveloperplatform/public-site/tree/main/content/community/experts"
click node_community_events "https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/events.md"
click node_community_articles "https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/articles.md"
click node_war_stories "https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/war-stories.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_learning_core,node_learning_guides toneBlue
class node_ecosystem_index,node_paas,node_tooling,node_developer_portals,node_kubernetes,node_monitoring toneAmber
class node_community_index,node_consultancies,node_experts,node_community_events,node_community_articles,node_war_stories toneMint
class node_contributor,node_hugo,node_public_site toneIndigo
```

## Components

### Learning Guides

- [Core Components](https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn/core-components): `content/learn/core-components`
- [IDP Guides](https://github.com/internaldeveloperplatform/public-site/tree/main/content/learn): `content/learn`

### Ecosystem Directory

- [Ecosystem Overview](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem): `content/ecosystem`
- [Platform Services](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/paas-devops-platforms): `content/ecosystem/paas-devops-platforms`
- [Platform Tooling](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling): `content/ecosystem/platform-tooling`
- [Developer Portals](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/developer-portals): `content/ecosystem/platform-tooling/developer-portals`
- [Kubernetes](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/kubernetes): `content/ecosystem/platform-tooling/kubernetes`
- [Monitoring](https://github.com/internaldeveloperplatform/public-site/tree/main/content/ecosystem/platform-tooling/monitoring): `content/ecosystem/platform-tooling/monitoring`

### Community Resources

- [Community Overview](https://github.com/internaldeveloperplatform/public-site/tree/main/content/community): `content/community`
- [Consultancies](https://github.com/internaldeveloperplatform/public-site/tree/main/content/community/consultancies): `content/community/consultancies`
- [Experts](https://github.com/internaldeveloperplatform/public-site/tree/main/content/community/experts): `content/community/experts`
- [Events](https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/events.md): `content/community/events.md`
- [Articles And Books](https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/articles.md): `content/community/articles.md`
- [War Stories](https://github.com/internaldeveloperplatform/public-site/blob/main/content/community/war-stories.md): `content/community/war-stories.md`

### Other components

- **Contributor**
- **Hugo Generator**
- **Public Static Site**

## Connections

- Contributor → Core Components: contributes content (evidence: `README.md`)
- Contributor → IDP Guides: contributes content (evidence: `README.md`)
- Contributor → Ecosystem Overview: contributes content (evidence: `README.md`)
- Contributor → Platform Services: contributes content (evidence: `README.md`)
- Contributor → Platform Tooling: contributes content (evidence: `README.md`)
- Contributor → Developer Portals: contributes content (evidence: `README.md`)
- Contributor → Kubernetes: contributes content (evidence: `README.md`)
- Contributor → Monitoring: contributes content (evidence: `README.md`)
- Contributor → Community Overview: contributes content (evidence: `README.md`)
- Contributor → Consultancies: contributes content (evidence: `README.md`)
- Contributor → Experts: contributes content (evidence: `README.md`)
- Contributor → Events: contributes content (evidence: `README.md`)
- Contributor → Articles And Books: contributes content (evidence: `README.md`)
- Contributor → War Stories: contributes content (evidence: `README.md`)
- Core Components → Hugo Generator: generates from Markdown (evidence: `README.md`)
- IDP Guides → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Ecosystem Overview → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Platform Services → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Platform Tooling → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Developer Portals → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Kubernetes → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Monitoring → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Community Overview → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Consultancies → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Experts → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Events → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Articles And Books → Hugo Generator: generates from Markdown (evidence: `README.md`)
- War Stories → Hugo Generator: generates from Markdown (evidence: `README.md`)
- Hugo Generator → Public Static Site: generates site (evidence: `README.md`)
