From 54fd96db657e8f980d2b8d555983fe082914b975 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Sun, 2 Aug 2026 15:20:10 +0200 Subject: [PATCH] State where documentation content lives in a documentation repository The section answered which surface owns the docs per repository type, but not where content sits in the repo. Left open, content lands in the root and the root stops being readable. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- src/docs/Ways-of-Working/Repository-Standard.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/docs/Ways-of-Working/Repository-Standard.md b/src/docs/Ways-of-Working/Repository-Standard.md index 787b862..b636dfd 100644 --- a/src/docs/Ways-of-Working/Repository-Standard.md +++ b/src/docs/Ways-of-Working/Repository-Standard.md @@ -69,6 +69,8 @@ Default expectations by repository type: | Reusable workflows | The README is the main documentation surface because callers need workflow interface, permissions, secrets, and examples in the repository. | | Documentation repositories | The published site is the product. The repository README only explains the source repo and local contribution/build entry points. | +Documentation content lives in one folder, never spread across the repository root. A repository whose product is content — a documentation site, a reference collection, an archive of external material — keeps that content under a single documentation root: `docs/` by default, or a generator's source root such as `src/docs/` when the site tooling needs one. The repository root stays reserved for the README, the tooling, and the governance files, so a reader can tell content from machinery without opening a folder. + Initiative docs define the implementation: exact folder layout, publishing workflow, URL convention, and which repositories are exceptions. MSX defines the expectation that product docs have an owner and that README pages stay small. ## Dependency and supply-chain defaults