Skip to content

docs: use ADR-NNNN in the conflict example so the citation check does not resolve it - #44

Merged
lesnik512 merged 1 commit into
mainfrom
adr-example-placeholder
Sep 27, 2026
Merged

lesnik512 merged 1 commit into
mainfrom
adr-example-placeholder

Conversation

@lesnik512

Copy link
Copy Markdown
Member

What

docs/agents/domain.md shows how to flag an ADR conflict with the example _Contradicts ADR-0007 (event-sourced orders)…_. The number becomes the placeholder ADR-NNNN.

Why

modern-python/.github#120 made the shared ADR citation check resolve bare ADR-NNNN numbers against docs/adr/. ADR-0007 in this example is illustrative, names no record here, and would be reported as a broken citation. NNNN is not a number, so it is not a citation. The example reads the same.

Verified

The current shared check run against this repo with the change: 9 passed (1 failed before).

@lesnik512
lesnik512 merged commit 93b9158 into main Sep 27, 2026
2 checks passed
@lesnik512
lesnik512 deleted the adr-example-placeholder branch September 27, 2026 20:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant