# microsoftdocs/microsoft-365-docs architecture

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

- Interactive diagram: https://gitdiagram.com/microsoftdocs/microsoft-365-docs
- Repository: https://github.com/microsoftdocs/microsoft-365-docs

## Overview

This repository is a Microsoft Learn documentation content set, not an application runtime. Its principal workflow is that a contributor edits an article on GitHub, proposes the change in a pull request, an article owner or other reviewer reviews and approves it, and the merged content is published to Microsoft Learn. The tree shows broad Copilot and Microsoft 365 subject areas; their internal implementation and any further publishing mechanics were not sampled, so no additional runtime links are inferred.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Contribution workflow"]
  node_github["GitHub"]
  node_article["Article files"]
end

subgraph group_copilot["Copilot content"]
  node_copilot_docs["Copilot guidance"]
  node_agents["Agent guidance"]
  node_copilot_admin["Copilot administration"]
  node_employee_service["Employee self-service"]
  node_copilot_security["Copilot security"]
end

subgraph group_m365["Microsoft 365 content"]
  node_m365_docs["Microsoft 365 guidance"]
  node_admin["Admin guidance"]
  node_commerce["Commerce guidance"]
  node_backup["Backup guidance"]
  node_archive["Archive guidance"]
  node_security["Security guidance"]
end

subgraph group_learn["Published documentation"]
  node_learn_site["Microsoft Learn"]
end

node_contributor(("Contributor"))
node_reviewer(("Article reviewer"))

node_contributor -->|"edits on"| node_github
node_github -->|"updates article"| node_article
node_contributor -->|"proposes changes"| node_github
node_github -->|"notifies owner"| node_reviewer
node_reviewer -->|"reviews and approves"| node_github
node_github -->|"publishes merged content"| node_learn_site

click node_copilot_docs "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot"
click node_agents "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/agent-essentials"
click node_copilot_admin "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/copilot-control-system"
click node_employee_service "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/employee-self-service"
click node_copilot_security "https://github.com/microsoftdocs/microsoft-365-docs/blob/public/copilot/security-microsoft-365-copilot.md"
click node_m365_docs "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365"
click node_admin "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/admin"
click node_commerce "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/commerce"
click node_backup "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/backup"
click node_archive "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/archive"
click node_security "https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/security"

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_github,node_article,node_reviewer toneBlue
class node_copilot_docs,node_agents,node_copilot_admin,node_employee_service,node_copilot_security toneAmber
class node_m365_docs,node_admin,node_commerce,node_backup,node_archive,node_security toneMint
class node_learn_site toneRose
class node_contributor toneIndigo
```

## Components

### Contribution workflow

- **GitHub**
- **Article files**

### Copilot content

- [Copilot guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot): `copilot`
- [Agent guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/agent-essentials): `copilot/agent-essentials`
- [Copilot administration](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/copilot-control-system): `copilot/copilot-control-system`
- [Employee self-service](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/copilot/employee-self-service): `copilot/employee-self-service`
- [Copilot security](https://github.com/microsoftdocs/microsoft-365-docs/blob/public/copilot/security-microsoft-365-copilot.md): `copilot/security-microsoft-365-copilot.md`

### Microsoft 365 content

- [Microsoft 365 guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365): `microsoft-365`
- [Admin guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/admin): `microsoft-365/admin`
- [Commerce guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/commerce): `microsoft-365/commerce`
- [Backup guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/backup): `microsoft-365/backup`
- [Archive guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/archive): `microsoft-365/archive`
- [Security guidance](https://github.com/microsoftdocs/microsoft-365-docs/tree/public/microsoft-365/security): `microsoft-365/security`

### Published documentation

- **Microsoft Learn**

### Other components

- **Contributor**
- **Article reviewer**

## Connections

- Contributor → GitHub: edits on
- GitHub → Article files: updates article
- Contributor → GitHub: proposes changes
- GitHub → Article reviewer: notifies owner
- Article reviewer → GitHub: reviews and approves
- GitHub → Microsoft Learn: publishes merged content