Skip to content

docs(adr): finish System → Module in the naming ADRs (ADR-0014/0025)#56

Closed
wmadden-electric wants to merge 1 commit into
mainfrom
claude/adr-system-to-module-cleanup
Closed

docs(adr): finish System → Module in the naming ADRs (ADR-0014/0025)#56
wmadden-electric wants to merge 1 commit into
mainfrom
claude/adr-system-to-module-cleanup

Conversation

@wmadden-electric

Copy link
Copy Markdown
Contributor

Follow-up to the System → Module rename (#52): brings the two naming ADRs into
Module terms. These two are the record of the naming decision itself, so this is a
coherent rewrite, not a find-replace — a blind swap would make ADR-0025 say
"Module leaves the vocabulary entirely" and leave ADR-0014's Alternatives section
rejecting "Module."

ADR-0014 — rewritten in Module terms

  • Keeps its still-standing decisions: framework Prisma App, the @prisma/app*
    packages, the prisma-app CLI, and one authoring primitive module() with no
    separate app() (the App is the outermost Module).
  • Drops the pro-"System" argument and the now-wrong "Module rejected" alternative;
    defers the unit-noun choice to ADR-0025.
  • Renamed …-and-its-unit-system.md…-name-the-framework-prisma-app.md; every
    inbound link updated (glossary, layering, naming.md, naming-proposal.md, the
    decisions index, ADR-0025).

ADR-0025 — made self-contained

  • It's the record of the rename, so "System" still appears — but only as the
    retired name it documents, never as live vocabulary.
  • Reworded the few references that pointed at claims I removed from ADR-0014 (the
    "nobody says my auth module" claim, the Nest-collision reading, the Service/System
    glossary note) so nothing dangles; retargeted the ADR-0014 link.

Docs-only; no code touched. pnpm lint clean. No dangling links repo-wide.

Brings ADR-0014 and ADR-0025 into Module terms, per the same rename. These two
are the record of the naming decision itself, so this is a coherent rewrite, not
a find-replace (a blind swap would make ADR-0025 say "Module leaves the vocabulary
entirely" and ADR-0014 reject "Module").

- ADR-0014 rewritten in current Module terms: keeps its still-standing decisions
  (framework Prisma App, @prisma/app* packages, prisma-app CLI, one authoring
  primitive module(), App is the outermost Module), drops the pro-System argument
  and the now-wrong "Module rejected" alternative, and defers the unit noun to
  ADR-0025. Filename → ADR-0014-name-the-framework-prisma-app.md; all inbound
  links updated (glossary, layering, naming, naming-proposal, decisions index).
- ADR-0025 made self-contained: "System" now appears only as the retired name it
  documents; references to claims removed from ADR-0014 reworded so nothing
  dangles; ADR-0014 link retargeted.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: willbot <w.a.madden+machine@gmail.com>
Signed-off-by: Will Madden <madden@prisma.io>
@wmadden-electric

Copy link
Copy Markdown
Contributor Author

Consolidated into #57 — its ADR-0014/0025 System→Module cleanup is included there (cherry-picked and carried forward). #57 is the single PR.

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