Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions BRIEF.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,12 @@ Ordering rationale: the spec first because it is the least invasive change and u
- Git: never squash, never rewrite history; keep the upstream remote; cherry-pick with attribution.
- A change of technical direction requires written justification with three parts: (1) why the previous approach does not work, (2) whether it can be made to work, (3) why the new approach is better. No exceptions.
- Process over result: if the process fails, fix the process. Never bypass it.
- **Issues live in the repository they concern.** Work that lands in a repository
gets an issue there and is closed by a pull request there. `tracker` is only for
what is common to the whole organization: cross-repo ordering, org-wide decisions,
things that belong to no single repo. Cross-referencing between the two is
encouraged; filing repo work in `tracker` instead of the repo is not. Open the
repo issue before delegating the work, never a task that exists only in a prompt.
- Licensing: forked code stays GPL. Licensing of new components is a maintainer decision.
- Documentation typography: no em dashes; use commas, colons, parentheses or semicolons; plain hyphen in numeric ranges.

Expand Down