Cross-cutting repository documentation lives here. Package- and feature-specific documentation should usually live next to the code it describes.

Start here when you are looking for repository-wide guidance or for documents that span multiple areas of the tree.

• Documentation guidelines - how to decide what belongs in repository documentation, where it should live, and how it should be maintained
• Bazel - Bazel-related repository guidance
• External consumption - guidance for externally consumed repository outputs

Documents under design/ capture design-time or broader cross-cutting context when a change needs alignment before or alongside implementation.

• Design documents - index of design-time documents