# Decisions The architecture decision records on a timeline: what was decided, when, and its status — twelve decisions from the trunk branch to the docs site, each with context, decision and consequences. - Page: - Updated: 2026-09-25 - From the Sri Guru Granth Sahib Ji — Knowledge Base wiki. Sri Guru Granth Sahib Ji is quoted verbatim, cited by Ang, and never altered. --- An ADR records one decision that shaped the system: the context, the decision, the consequences. They are numbered in the order they were written and never edited after acceptance — a later decision that changes course gets its own number and says so. The sibling repositories keep their own ADRs ([sggs-data](https://docs.gurbanisoul.com/data/#pinned-from-sggs-data), [gurbani-soul-ios](https://docs.gurbanisoul.com/ios/#pinned-from-gurbani-soul-ios)). On the rendered wiki this is a timeline; on GitHub, the records are the numbered files in this directory. ## Writing one Copy the newest record, take the next number, keep the three headings, and state the status with its date (`**Status:** accepted (YYYY-MM-DD)`). [Exercise 04](https://docs.gurbanisoul.com/exercises/04-write-an-adr/) walks through it.