docs: add French (Français) README by braiinz94 · Pull Request #5046 · github/spec-kit · GitHub
Skip to content

docs: add French (Français) README - #5046

Open
braiinz94 wants to merge 1 commit into
github:mainfrom
braiinz94:docs/french-readme
Open

braiinz94 wants to merge 1 commit into
github:mainfrom
braiinz94:docs/french-readme

Conversation

@braiinz94

Copy link
Copy Markdown

Description

Adds a French translation of the README (README.fr.md), following the same pattern as the Korean (#4939) and Japanese (#4560) README PRs:

  • README.fr.md is translated from the current English README, including the Capabilities and In the news sections.
  • The language switcher of every README (README.md, README.zh-CN.md, README.ja.md, README.ko.md) now links to Français.
  • README.fr.md is added to the markdownlint DOC_GLOBS in .github/workflows/lint.yml.

As in the Korean README, the legacy anchor IDs (-get-started, sdd-quickstart, …), every external link and every command block are kept identical to the English version, so existing deep links keep working and the commands stay copy-pasteable. Spec Kit component names (Extension, Preset, Workflow, Bundle) are kept as is; prose is translated.

This is a documentation-only change: no code, template, script or configuration that affects execution is modified.

Testing

Documentation-only change; the CLI and test suite are unaffected.

  • Tested locally with uv run specify --help — not applicable (no code change)
  • Ran existing tests with uv sync && uv run pytest — not applicable (no code change)
  • Tested with a sample project (if applicable) — not applicable

Checks run locally on README.fr.md against README.md (Python script, no repository code executed):

  • anchor IDs: identical, in the same order;
  • external links and image sources: identical;
  • fenced code blocks: identical (6 blocks);
  • in-page links (#développement-piloté-par-les-spécifications, #correction-de-bugs, #évaluation-didées, #fonctionnalités) all resolve to a heading;
  • same number of ## sections (11), no trailing whitespace, final newline.

markdownlint was not run locally; the markdownlint job in CI covers the new file.

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (fill in the disclosure below)

AI disclosure: Contribution by @braiinz94 (Mourad Barkaoui, native French speaker). The translation, the README link updates, the lint glob change, the commit and this PR description were produced by Claude Code (model: Claude Opus 5.5, default settings), working as an agent under the contributor's direction: he chose the contribution, set the constraints and approved opening this PR, but the commit was made before any line-by-line human review, hence autonomous in the commit's Assisted-by: trailer. Extent: documentation only (translation and link updates); no code was generated. Any reply in this PR that is AI-generated will say so.

🤖 Generated with Claude Code

Add README.fr.md, translated from the current English README (including
the Capabilities and In the news sections), and link it from the language
switcher of every README. Legacy anchor IDs, links and command blocks are
kept identical to the English version so existing deep links keep working.
Add the new file to the markdownlint document globs.

Assisted-by: Claude Code (model: Claude Opus 5.5, autonomous)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation-only changes preserve commands, external links, and anchors, with no blocking issues identified.

1 open issue
What changed in this PR

Adds a French README to Spec Kit’s multilingual documentation, preserving technical examples and links.

Changes:

  • Translates the current English README into French.
  • Adds French links to existing language switchers.
  • Includes the French README in Markdown linting.
File Description
README.zh-CN.md Adds French language link.
README.md Adds French language link.
README.ko.md Adds French language link.
README.ja.md Adds French language link.
README.fr.md Adds the French translation.
.github/​workflows/​lint.yml Includes French README in lint scope.

Review effort: Max

Comment thread README.fr.md
| --- | --- | --- |
| Construire une fonctionnalité ou une application | [Développement piloté par les spécifications](#développement-piloté-par-les-spécifications) | Une spécification menée jusqu'au plan, à l'implémentation et à la convergence |
| Diagnostiquer et réparer un comportement défaillant | [Correction de bugs](#correction-de-bugs) | Une cause évaluée, un correctif ciblé et une vérification consignée |
| Décider si une idée mérite d'être financée | [Évaluation d'idées](#évaluation-didées) | Une décision étayée : poursuivre, clarifier ou arrêter |
@mnriem

mnriem commented Oct 21, 2026

Copy link
Copy Markdown
Collaborator

@mnriem mnriem added the author-awaiting Waiting on author response label Oct 21, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author-awaiting Waiting on author response

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants