# huachao/azure-content architecture

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

- Interactive diagram: https://gitdiagram.com/huachao/azure-content
- Repository: https://github.com/huachao/azure-content

## Overview

This repository is Azure technical documentation: its product is Markdown articles and reusable content, not an application runtime. The documented contributor workflow is to find an article, edit it in GitHub for small changes or locally for substantial changes, then submit the change for review; published articles appear in the Azure Documentation Center. The tree shows service-specific content such as Active Directory and API Management. Relationships below follow the README; no source excerpts were provided, so implementation-level links are omitted.

Main entry points: [`articles`](https://github.com/huachao/azure-content/tree/master/articles) (Service articles), [`includes`](https://github.com/huachao/azure-content/tree/master/includes) (Reusable includes), [`markdown templates`](https://github.com/huachao/azure-content/tree/master/markdown%20templates) (Markdown templates), [`articles/active-directory/media`](https://github.com/huachao/azure-content/tree/master/articles/active-directory/media) (Article media)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Documentation content"]
  node_articles["Service articles"]
  node_includes["Reusable includes"]
  node_templates["Markdown templates"]
  node_media["Article media"]
end

subgraph group_contribution["Authoring and contribution"]
  node_github["GitHub editing"]
  node_local["Local authoring"]
  node_pullrequest["Pull request"]
end

subgraph group_publication["Publication"]
  node_azuredocs["Azure Documentation Center"]
end

node_contributor(("Contributor"))

node_contributor -->|"finds or edits"| node_articles
node_contributor -->|"edits small changes"| node_github
node_github -->|"updates content"| node_articles
node_contributor -->|"authors substantial changes"| node_local
node_local -->|"updates content"| node_articles
node_local -->|"adds or changes images"| node_media
node_templates -->|"guides formatting"| node_articles
node_includes -->|"provides reusable sections"| node_articles
node_contributor -->|"submits changes"| node_pullrequest
node_pullrequest -->|"publishes articles"| node_azuredocs

click node_articles "https://github.com/huachao/azure-content/tree/master/articles"
click node_includes "https://github.com/huachao/azure-content/tree/master/includes"
click node_templates "https://github.com/huachao/azure-content/tree/master/markdown%20templates"
click node_media "https://github.com/huachao/azure-content/tree/master/articles/active-directory/media"

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_articles,node_includes,node_templates,node_media toneBlue
class node_github,node_local,node_pullrequest toneAmber
class node_azuredocs toneMint
class node_contributor toneIndigo
```

## Components

### Documentation content

- [Service articles](https://github.com/huachao/azure-content/tree/master/articles): `articles`
- [Reusable includes](https://github.com/huachao/azure-content/tree/master/includes): `includes`
- [Markdown templates](https://github.com/huachao/azure-content/tree/master/markdown%20templates): `markdown templates`
- [Article media](https://github.com/huachao/azure-content/tree/master/articles/active-directory/media): `articles/active-directory/media`

### Authoring and contribution

- **GitHub editing**
- **Local authoring**
- **Pull request**

### Publication

- **Azure Documentation Center**

### Other components

- **Contributor**

## Connections

- Contributor → Service articles: finds or edits (evidence: `README.md`)
- Contributor → GitHub editing: edits small changes (evidence: `README.md`)
- GitHub editing → Service articles: updates content (evidence: `README.md`)
- Contributor → Local authoring: authors substantial changes (evidence: `README.md`)
- Local authoring → Service articles: updates content (evidence: `README.md`)
- Local authoring → Article media: adds or changes images (evidence: `README.md`)
- Markdown templates → Service articles: guides formatting (evidence: `README.md`)
- Reusable includes → Service articles: provides reusable sections (evidence: `README.md`)
- Contributor → Pull request: submits changes (evidence: `README.md`)
- Pull request → Azure Documentation Center: publishes articles (evidence: `README.md`)
