Skip to content
Merged
Show file tree
Hide file tree
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
1 change: 1 addition & 0 deletions .github/workflows/pr-check-managed-files-hosted.yml
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ on:
- docs/standards/design-for-change.md
- docs/standards/deterministic-work-execution.md
- docs/standards/documentation-and-citations.md
- docs/standards/issue-tracker.md
- docs/standards/reference-dont-duplicate.md
- docs/standards/simpler-code.md
- docs/standards/source-authority-tiers.md
Expand Down
4 changes: 3 additions & 1 deletion docs/standards/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@ standards-contract: 1.0.2
# Standards index

Team-layer engineering standards synced from melodic-software/standards
(`standards/engineering/`). Change them there, not here.
(`standards/engineering/` and `standards/process/issue-tracker.md`). Change them
there, not here.

| Surface | Applies when | File |
|---|---|---|
Expand All @@ -14,6 +15,7 @@ Team-layer engineering standards synced from melodic-software/standards
| design-for-change | designing or reviewing a module boundary, an extension point, configuration, dependency wiring, or a design pattern; any change whose reversal would edit many files | design-for-change.md |
| deterministic-work-execution | counts, diffs, sorting, arithmetic, inventories; composing shell commands an agent runs | deterministic-work-execution.md |
| documentation-and-citations | citing upstream docs; recording an external default or version; labeling the basis of a recommendation | documentation-and-citations.md |
| issue-tracker | filing, titling, triaging or closing an issue; adding, renaming or deleting a label, issue field or milestone; choosing labels versus fields | issue-tracker.md |
| reference-dont-duplicate | a fact, value, or rule appearing in more than one place; origin or history notes in code or docs | reference-dont-duplicate.md |
| simpler-code | writing or reviewing code; proposing a new check, process, document, or dependency; serializing work; keeping an existing mechanism | simpler-code.md |
| source-authority-tiers | grounding a recommendation, option, or decision; judging how much a source is worth | source-authority-tiers.md |
Loading