# google/eng-practices architecture

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

- Interactive diagram: https://gitdiagram.com/google/eng-practices
- Repository: https://github.com/google/eng-practices

## Overview

This repository is a documentation product: Google engineering practices, centered on code review guidance for reviewers and change authors. The documented user journey is to consult the code review guidelines, then use the appropriate reviewer or author guide. The tree also shows focused guidance on review standards, comments, navigation, speed, pushback, emergencies, and CL descriptions. Since no source excerpts are available, relationships beyond the README’s stated guide structure are not inferred; the topic pages are shown as documented content, not as a runtime pipeline.

Main entry points: [`review/index.md`](https://github.com/google/eng-practices/blob/master/review/index.md) (Code review guidelines), [`review/reviewer/index.md`](https://github.com/google/eng-practices/blob/master/review/reviewer/index.md) (Reviewer guide), [`review/developer/index.md`](https://github.com/google/eng-practices/blob/master/review/developer/index.md) (Change author guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_overview["Review overview"]
  node_review_index["Code review guidelines<br/>[index.md]"]
end

subgraph group_reviewer["Reviewer guidance"]
  node_reviewer_index["Reviewer guide<br/>[index.md]"]
  node_review_comments["Comments<br/>[comments.md]"]
  node_looking_for["What to look for<br/>[looking-for.md]"]
  node_navigate["Navigate reviews<br/>[navigate.md]"]
  node_pushback["Pushback<br/>[pushback.md]"]
  node_speed["Review speed<br/>[speed.md]"]
  node_standard["Review standard<br/>[standard.md]"]
end

subgraph group_author["Author guidance"]
  node_developer_index["Change author guide<br/>[index.md]"]
  node_cl_descriptions["CL descriptions<br/>[cl-descriptions.md]"]
  node_handling_comments["Handling comments"]
  node_small_cls["Small CLs<br/>[small-cls.md]"]
end

subgraph group_shared["Shared guidance"]
  node_emergencies["Emergencies<br/>[emergencies.md]"]
end

node_engineer(("Engineer"))

node_engineer -->|"consults"| node_review_index
node_review_index -->|"includes guide"| node_reviewer_index
node_review_index -->|"includes guide"| node_developer_index

click node_review_index "https://github.com/google/eng-practices/blob/master/review/index.md"
click node_reviewer_index "https://github.com/google/eng-practices/blob/master/review/reviewer/index.md"
click node_review_comments "https://github.com/google/eng-practices/blob/master/review/reviewer/comments.md"
click node_looking_for "https://github.com/google/eng-practices/blob/master/review/reviewer/looking-for.md"
click node_navigate "https://github.com/google/eng-practices/blob/master/review/reviewer/navigate.md"
click node_pushback "https://github.com/google/eng-practices/blob/master/review/reviewer/pushback.md"
click node_speed "https://github.com/google/eng-practices/blob/master/review/reviewer/speed.md"
click node_standard "https://github.com/google/eng-practices/blob/master/review/reviewer/standard.md"
click node_developer_index "https://github.com/google/eng-practices/blob/master/review/developer/index.md"
click node_cl_descriptions "https://github.com/google/eng-practices/blob/master/review/developer/cl-descriptions.md"
click node_handling_comments "https://github.com/google/eng-practices/blob/master/review/developer/handling-comments.md"
click node_small_cls "https://github.com/google/eng-practices/blob/master/review/developer/small-cls.md"
click node_emergencies "https://github.com/google/eng-practices/blob/master/review/emergencies.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_review_index toneBlue
class node_reviewer_index,node_review_comments,node_looking_for,node_navigate,node_pushback,node_speed,node_standard toneAmber
class node_developer_index,node_cl_descriptions,node_handling_comments,node_small_cls toneMint
class node_emergencies toneRose
class node_engineer toneIndigo
```

## Components

### Review overview

- [Code review guidelines](https://github.com/google/eng-practices/blob/master/review/index.md): `review/index.md`

### Reviewer guidance

- [Reviewer guide](https://github.com/google/eng-practices/blob/master/review/reviewer/index.md): `review/reviewer/index.md`
- [Comments](https://github.com/google/eng-practices/blob/master/review/reviewer/comments.md): `review/reviewer/comments.md`
- [What to look for](https://github.com/google/eng-practices/blob/master/review/reviewer/looking-for.md): `review/reviewer/looking-for.md`
- [Navigate reviews](https://github.com/google/eng-practices/blob/master/review/reviewer/navigate.md): `review/reviewer/navigate.md`
- [Pushback](https://github.com/google/eng-practices/blob/master/review/reviewer/pushback.md): `review/reviewer/pushback.md`
- [Review speed](https://github.com/google/eng-practices/blob/master/review/reviewer/speed.md): `review/reviewer/speed.md`
- [Review standard](https://github.com/google/eng-practices/blob/master/review/reviewer/standard.md): `review/reviewer/standard.md`

### Author guidance

- [Change author guide](https://github.com/google/eng-practices/blob/master/review/developer/index.md): `review/developer/index.md`
- [CL descriptions](https://github.com/google/eng-practices/blob/master/review/developer/cl-descriptions.md): `review/developer/cl-descriptions.md`
- [Handling comments](https://github.com/google/eng-practices/blob/master/review/developer/handling-comments.md): `review/developer/handling-comments.md`
- [Small CLs](https://github.com/google/eng-practices/blob/master/review/developer/small-cls.md): `review/developer/small-cls.md`

### Shared guidance

- [Emergencies](https://github.com/google/eng-practices/blob/master/review/emergencies.md): `review/emergencies.md`

### Other components

- **Engineer**

## Connections

- Engineer → Code review guidelines: consults (evidence: `README.md`)
- Code review guidelines → Reviewer guide: includes guide (evidence: `README.md`)
- Code review guidelines → Change author guide: includes guide (evidence: `README.md`)
