# kubernetes/website architecture

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

- Interactive diagram: https://gitdiagram.com/kubernetes/website
- Repository: https://github.com/kubernetes/website

## Overview

This repository is the source for the Kubernetes website and documentation. Its principal workflow is that readers browse the published site, whose pages draw on English and translated documentation plus related content such as blogs, releases, case studies, and community resources. API-reference assets and configuration support the documented reference pages. The tree and README establish these product areas, but the sampled source does not show Hugo’s page-rendering or deployment wiring, so those relationships are not inferred here.

Main entry points: [`content/en/docs/reference/kubernetes-api`](https://github.com/kubernetes/website/tree/main/content/en/docs/reference/kubernetes-api) (API reference pages), [`api-ref-assets/api`](https://github.com/kubernetes/website/tree/main/api-ref-assets/api) (API source assets), [`api-ref-assets/config`](https://github.com/kubernetes/website/tree/main/api-ref-assets/config) (API page configuration), [`api-ref-assets/templates`](https://github.com/kubernetes/website/tree/main/api-ref-assets/templates) (API templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Site content"]
  node_docs["Documentation"]
  node_translations["Localized content"]
  node_blogs["Blog posts"]
  node_cases["Case studies"]
  node_community["Community resources"]
  node_training["Training"]
  node_releases["Release information"]
end

subgraph group_reference["API reference"]
  node_api_pages["API reference pages"]
  node_api_assets["API source assets"]
  node_api_config["API page configuration"]
  node_api_templates["API templates"]
end

subgraph group_interaction["Site interaction"]
  node_api_navigation["API page navigation<br/>[apiref.js]"]
  node_redirects["Legacy redirects<br/>[redirects.js]"]
end

node_reader(("Website reader"))

node_reader -->|"browses"| node_docs
node_reader -->|"browses"| node_translations
node_reader -->|"browses"| node_blogs
node_reader -->|"browses"| node_cases
node_reader -->|"browses"| node_community
node_reader -->|"browses"| node_training
node_reader -->|"browses"| node_releases
node_reader -->|"browses"| node_api_pages
node_api_pages -->|"uses navigation"| node_api_navigation
node_reader -->|"loads page"| node_redirects
node_api_assets -.->|"documents source"| node_api_pages
node_api_config -.->|"documents configuration"| node_api_pages
node_api_templates -.->|"documents templates"| node_api_pages

click node_docs "https://github.com/kubernetes/website/tree/main/content/en"
click node_translations "https://github.com/kubernetes/website/tree/main/content"
click node_blogs "https://github.com/kubernetes/website/tree/main/content/en/blog"
click node_community "https://github.com/kubernetes/website/tree/main/content/en/community"
click node_training "https://github.com/kubernetes/website/tree/main/content/en/training"
click node_releases "https://github.com/kubernetes/website/tree/main/content/en/releases"
click node_api_pages "https://github.com/kubernetes/website/tree/main/content/en/docs/reference/kubernetes-api"
click node_api_assets "https://github.com/kubernetes/website/tree/main/api-ref-assets/api"
click node_api_config "https://github.com/kubernetes/website/tree/main/api-ref-assets/config"
click node_api_templates "https://github.com/kubernetes/website/tree/main/api-ref-assets/templates"
click node_api_navigation "https://github.com/kubernetes/website/blob/main/static/js/apiref.js"
click node_redirects "https://github.com/kubernetes/website/blob/main/static/js/redirects.js"

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_docs,node_translations,node_blogs,node_cases,node_community,node_training,node_releases toneBlue
class node_api_pages,node_api_assets,node_api_config,node_api_templates toneAmber
class node_api_navigation,node_redirects toneMint
class node_reader toneIndigo
```

## Components

### Site content

- [Documentation](https://github.com/kubernetes/website/tree/main/content/en): `content/en`
- [Localized content](https://github.com/kubernetes/website/tree/main/content): `content`
- [Blog posts](https://github.com/kubernetes/website/tree/main/content/en/blog): `content/en/blog`
- **Case studies**
- [Community resources](https://github.com/kubernetes/website/tree/main/content/en/community): `content/en/community`
- [Training](https://github.com/kubernetes/website/tree/main/content/en/training): `content/en/training`
- [Release information](https://github.com/kubernetes/website/tree/main/content/en/releases): `content/en/releases`

### API reference

- [API reference pages](https://github.com/kubernetes/website/tree/main/content/en/docs/reference/kubernetes-api): `content/en/docs/reference/kubernetes-api`
- [API source assets](https://github.com/kubernetes/website/tree/main/api-ref-assets/api): `api-ref-assets/api`
- [API page configuration](https://github.com/kubernetes/website/tree/main/api-ref-assets/config): `api-ref-assets/config`
- [API templates](https://github.com/kubernetes/website/tree/main/api-ref-assets/templates): `api-ref-assets/templates`

### Site interaction

- [API page navigation](https://github.com/kubernetes/website/blob/main/static/js/apiref.js): `static/js/apiref.js`
- [Legacy redirects](https://github.com/kubernetes/website/blob/main/static/js/redirects.js): `static/js/redirects.js`

### Other components

- **Website reader**

## Connections

- Website reader → Documentation: browses
- Website reader → Localized content: browses
- Website reader → Blog posts: browses
- Website reader → Case studies: browses
- Website reader → Community resources: browses
- Website reader → Training: browses
- Website reader → Release information: browses
- Website reader → API reference pages: browses
- API reference pages → API page navigation: uses navigation
- Website reader → Legacy redirects: loads page
- API source assets → API reference pages: documents source
- API page configuration → API reference pages: documents configuration
- API templates → API reference pages: documents templates