# linode/docs architecture

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

- Interactive diagram: https://gitdiagram.com/linode/docs
- Repository: https://github.com/linode/docs

## Overview

This repository is the source and maintenance toolkit for Linode’s Linux, web-server, and development guides. The reader workflow is to consult the hosted guide library; the README names the site, but the supplied tree contains no guide content or application serving it, so that workflow is shown at a high level. The tree does include a guide-move utility and search-index maintenance scripts. Vendored Turbo and Alpine sources are dependencies, not the documentation product. Evidence is limited to the README, tree, and sampled excerpts.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Guide Library"]
  node_guides["Tutorial guides"]
end

subgraph group_maintenance["Content Maintenance"]
  node_move["Move guides<br/>[mv-guide.py]"]
  node_search_index["Search indexing<br/>[main.go]"]
end

node_reader(("Guide reader"))

node_reader -->|"reads"| node_guides

click node_move "https://github.com/linode/docs/blob/develop/mv-guide.py"
click node_search_index "https://github.com/linode/docs/blob/develop/scripts/update_linode_docs_search_indices/main.go"

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_guides toneBlue
class node_move,node_search_index toneAmber
class node_reader toneIndigo
```

## Components

### Guide Library

- **Tutorial guides**

### Content Maintenance

- [Move guides](https://github.com/linode/docs/blob/develop/mv-guide.py): `mv-guide.py`
- [Search indexing](https://github.com/linode/docs/blob/develop/scripts/update_linode_docs_search_indices/main.go): `scripts/update_linode_docs_search_indices/main.go`

### Other components

- **Guide reader**

## Connections

- Guide reader → Tutorial guides: reads