Skip to content

docs: make the ADR base bilingual and accept ADR-0007#162

Merged
Reefact merged 1 commit into
mainfrom
claude/adr-french-translation-pq5tit
Jul 16, 2026
Merged

docs: make the ADR base bilingual and accept ADR-0007#162
Reefact merged 1 commit into
mainfrom
claude/adr-french-translation-pq5tit

Conversation

@Reefact

@Reefact Reefact commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Add a French translation alongside every ADR so the ADR base matches the repository's bilingual documentation — English stays canonical, the French text is a convenience for the project's maintainers. ADR-0007 is recorded as Accepted so its translation is created in the same accepted state as the other six.

Type of change

  • Documentation

Changes

  • Add a French translation (NNNN-short-title.fr.md) for all seven ADRs (0001–0007), structured identically to the English source.
  • Add a language banner to every ADR — English and French — linking to its counterpart, matching the rest of maintainers/.
  • Record the bilingual convention in maintainers/adr/README.md (English canonical, French kept alongside as NNNN-short-title.fr.md).
  • Accept ADR-0007 (ProposedAccepted, dated 2026-07-16) and flip its row in the index.
  • Harmonize French terminology with the existing corpus: librairie (not « bibliothèque »), package (dominant over « paquet »), and the .NET assembly kept as assembly (one glossary-induced « assembleur » mistranslation in ADR-0002 corrected).

Testing

Documentation-only change — no source code is touched, so the build/test suites were not run. Instead the change was verified structurally:

  • Every internal link in the French files resolves to an existing file.
  • All 14 ADR files carry the language banner.
  • The English ADR bodies are unchanged except for the banner insertion and ADR-0007's status/date.

Documentation

  • README / doc/ updated — the ADR base under maintainers/adr/ (English + French, plus the convention note in its README).

No public API or user-facing behavior changed, so doc/ guides and doc/README.fr.md are untouched.

Architecture decisions

  • No architectural decision in this pull request

Advisory notes for the maintainer:

  • Making the ADR base bilingual was judged not ADR-worthy — it extends the repository's existing bilingual-documentation convention to one more folder rather than being a new cross-cutting decision. It does change a written convention line in maintainers/adr/README.md; flagging it for your call.
  • This PR records your acceptance of ADR-0007 (the agent performed the status edit; the decision is the maintainer's), consistent with "no agent accepts or supersedes an ADR".

Related issues

None.


Generated by Claude Code

Add a French translation (NNNN-short-title.fr.md) next to every ADR, so
the ADR base matches the repository's bilingual documentation. English
stays canonical; the French text is a convenience for the project's
maintainers. Every ADR, English and French, gains a language banner
linking to its counterpart, and the ADR README records the convention.

Accept ADR-0007 (Proposed to Accepted, dated 2026-07-16) and update the
index, so its translation is created in the same accepted state as the
other six.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UuQaQ1M3TsydDPvJ8Gw6YH
@Reefact
Reefact force-pushed the claude/adr-french-translation-pq5tit branch from 6dcd71f to 17929a5 Compare July 16, 2026 11:17
@Reefact
Reefact merged commit 03c94a6 into main Jul 16, 2026
12 checks passed
@Reefact
Reefact deleted the claude/adr-french-translation-pq5tit branch July 16, 2026 11:20
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.

2 participants