Skip to content

ADR numbering collision: three files share 00018 in docs/developing/decisions/ #162

Description

@theRTC204

docs/developing/decisions/README.md states ADRs are "append-only and numbered sequentially," but three files currently share the number 00018:

  • 00018-external-instance-directory-registry.md
  • 00018-fragment-metadata-on-s3-objects.md
  • 00018-view-independent-merges-and-subtree-grafting.md

These landed in commits 243e52b, fe4f4e5, and 1fe7e28 respectively — apparently three parallel changes each independently incremented from the last number they saw (00017) without knowing about the others, and merged without renumbering.

Since ADRs are append-only, renaming these already-published files seems wrong (it would break any existing links/citations to "ADR-00018" and rewrite merged history). Filing this so a maintainer can decide the right fix — e.g. renumber two of the three going forward, or accept the collision and just document which 00018 is which.

Note: 00019 and 00020 are currently unused, so new ADRs can continue sequentially from 00019 without conflict in the meantime.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationneeds-triageNot yet reviewed by a maintainer, awaiting initial triage

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions