Skip to content

docs(cs): add Czech (Čeština) documentation translation#2134

Open
JakubStejskalCZ wants to merge 5 commits intobmad-code-org:mainfrom
JakubStejskalCZ:docs/czech-translation
Open

docs(cs): add Czech (Čeština) documentation translation#2134
JakubStejskalCZ wants to merge 5 commits intobmad-code-org:mainfrom
JakubStejskalCZ:docs/czech-translation

Conversation

@JakubStejskalCZ
Copy link
Copy Markdown

What

Add complete Czech (Čeština) documentation translation — 29 files mirroring English docs structure with locale config registration.

Why

Expand BMad accessibility to Czech-speaking developers, following the pattern of existing French and Chinese translations.
Fixes #2133

How

  • Created docs/cs/ with all 29 translated files (index, 404, style guide, roadmap, 1 tutorial, 9 how-to guides, 9 explanations, 6 references)
  • Registered cs locale (cs-CZ) in website/src/lib/locales.mjs
  • Added Czech sidebar translations in website/astro.config.mjs (Vítejte, Plán rozvoje, Tutoriály, Praktické návody, Vysvětlení, Reference)
  • Preserved all internal links, sidebar orders, and frontmatter structure

Testing

  • npm run docs:build passes with zero errors, all 28 HTML pages generated under build/site/cs/
  • All pre-commit hooks pass (tests, linting, markdown lint, formatting)
  • Verified 1:1 file parity with English docs
  • Manual review via npm run docs:dev at /cs/

JakubStejskalCZ and others added 2 commits March 26, 2026 13:32
Add complete Czech translation of all 29 documentation files mirroring
the English source structure. Register cs-CZ locale in Starlight config
with sidebar label translations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Fix UTF-8 encoding artifacts in customize-bmad.md and upgrade-to-v6.md,
align markdown table formatting, and correct Czech grammar in
project-context.md heading.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 26, 2026

📝 Walkthrough

Walkthrough

Adds a Czech (Čeština) translation of the BMad Method documentation: 29 new Czech docs under docs/cs/ (tutorials, how-to, explanations, references, style guide, roadmap, and support pages) mirroring the English documentation structure.

Changes

Cohort / File(s) Summary
Foundation & Landing
docs/cs/404.md, docs/cs/index.md, docs/cs/_STYLE_GUIDE.md
New Czech 404 page, Czech documentation index/landing page, and a comprehensive Czech style guide defining formatting, admonitions, templates, and validation commands.
Tutorials
docs/cs/tutorials/getting-started.md
New Czech getting-started tutorial covering install, the four-phase BMad process, planning paths, workflow commands, example project layout, and FAQs.
How-to Guides
docs/cs/how-to/install-bmad.md, docs/cs/how-to/non-interactive-installation.md, docs/cs/how-to/get-answers-about-bmad.md, docs/cs/how-to/customize-bmad.md, docs/cs/how-to/established-projects.md, docs/cs/how-to/project-context.md, docs/cs/how-to/quick-fixes.md, docs/cs/how-to/shard-large-documents.md, docs/cs/how-to/upgrade-to-v6.md
Multiple Czech how-to pages: installation (interactive & non-interactive/CI), using bmad-help, agent customization via .customize.yaml, workflows for established projects, creating/maintaining project-context, quick fixes, document sharding, and v4→v6 upgrade guidance.
Explanations
docs/cs/explanation/advanced-elicitation.md, docs/cs/explanation/adversarial-review.md, docs/cs/explanation/brainstorming.md, docs/cs/explanation/established-projects-faq.md, docs/cs/explanation/party-mode.md, docs/cs/explanation/preventing-agent-conflicts.md, docs/cs/explanation/project-context.md, docs/cs/explanation/quick-dev.md, docs/cs/explanation/why-solutioning-matters.md
Czech conceptual docs on advanced elicitation, adversarial review, brainstorming, established-projects FAQ, party-mode multi-agent collaboration, preventing agent conflicts (ADRs/standards), project-context purpose, quick-dev control flow, and solutioning importance.
References
docs/cs/reference/agents.md, docs/cs/reference/commands.md, docs/cs/reference/core-tools.md, docs/cs/reference/modules.md, docs/cs/reference/testing.md, docs/cs/reference/workflow-map.md
Reference pages documenting default agents and triggers, skills/IDE locations, core built-in tools catalog, modules catalog, testing options (Quinn vs TEA), and the BMad workflow map with artifact mappings.
Roadmap
docs/cs/roadmap.mdx
New Czech roadmap page with in-progress/upcoming/community items and CTA links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • alexeyv
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The PR title clearly describes the main change: adding Czech documentation translation with all 29 files across key sections.
Description check ✅ Passed The description is well-structured, relating directly to the changeset by explaining what files were added, why (expanding accessibility), how (locale registration and sidebar translations), and testing confirmation.
Linked Issues check ✅ Passed The PR fully meets all coding requirements from issue #2133: 29 translated files under docs/cs/, locale registration in locales.mjs, Czech sidebar translations in astro.config.mjs, and verified parity with English docs.
Out of Scope Changes check ✅ Passed All changes are in-scope: Czech documentation files (docs/cs/), locale registration, and sidebar config updates. No unrelated modifications detected beyond the documented Czech translation deliverables.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 9

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/cs/_STYLE_GUIDE.md`:
- Line 14: Replace mixed or mismatched quotation marks with Czech typographic
quotes throughout the document; e.g., change occurrences like the table cell
string containing Žádné sekce „Souvisejí" nebo „Další: to use matching Czech
pairs („…“) so it becomes Žádné sekce „Souvisejí“ nebo „Další:“ and apply the
same normalization to the other reported user-facing strings (the other table
entries and headings referenced in the review) so all opening quotes are „ and
closing quotes are “ consistently.

In `@docs/cs/explanation/project-context.md`:
- Line 8: Replace the mismatched Czech quotation in the user-facing phrase
containing „ústava" so it becomes a properly paired Czech quote „ústava“, i.e.,
locate the token that currently reads „ústava" and change the trailing ASCII
double-quote to the Czech closing quote “ (U+201D) so the phrase reads „ústava“.

In `@docs/cs/how-to/non-interactive-installation.md`:
- Around line 49-56: Update the `--modules` ID list to include the missing
official module IDs `cis`, `gds`, `tea`, and `wds` in addition to `bmm` and
`bmb`; ensure the doc also notes that `bmm` is a built-in module managed by the
modules manager and verify the list against the official registry file
(external-official-modules.yaml) and the modules manager (modules/manager.js) so
non-interactive install configs are accurate.

In `@docs/cs/how-to/upgrade-to-v6.md`:
- Line 77: Replace the corrupted mojibake sequence "├─��� bmm/" with a proper
box-drawing branch line such as "├── bmm/" so the directory tree renders
correctly; update the exact string "├─��� bmm/" to "├── bmm/" in the document
(leave the rest of the line unchanged).

In `@docs/cs/index.md`:
- Line 11: The roadmap link in docs/cs/index.md points to /roadmap/ (site root);
change it to a relative locale-aware link matching the French pattern by
replacing the current markdown link text “[Podívejte se na Plán rozvoje
→](/roadmap/)” with “[Podívejte se na Plán rozvoje →](./roadmap)” so the Czech
index stays within the Czech locale (see docs/fr/index.md for the exact
pattern).

In `@docs/cs/reference/agents.md`:
- Line 28: Remove the nonexistent trigger code `US` from the Technical Writer
(Paige) agent documentation and conversational triggers: search for the
"Technical Writer (Paige)" table rows and any conversational triggers tables and
delete the `US` token from the list of trigger codes (e.g., change `DP`, `WD`,
`US`, `MG`, `VD`, `EC` to `DP`, `WD`, `MG`, `VD`, `EC`), then repeat the same
removal in all language versions and update any summary/skills tables (SKILL.md
references) so the docs match the implemented capabilities.

In `@docs/cs/reference/modules.md`:
- Line 61: In the section intro where the Czech word "Podníková" is used,
replace that typo with the correct word "Podniková" so the sentence begins
"Podniková testovací strategie..." and update any identical occurrences in the
same paragraph (search for "Podníková") to maintain consistency.

In `@docs/cs/reference/testing.md`:
- Line 45: The heading sentence currently mixes a Czech opening quote with an
ASCII double-quote; replace the mismatched ASCII closing quote after jednoduché
a udržovatelné with a proper Czech closing quotation mark so the line reads:
„jednoduché a udržovatelné“: (i.e., use U+201E for the opening and U+201D for
the closing around jednoduché a udržovatelné).

In `@docs/cs/tutorials/getting-started.md`:
- Line 36: Replace mismatched Czech quotation marks so user-facing examples use
paired Czech quotes. Find occurrences of the example string starting with
"Odpoví na otázky" that currently use an opening „ and a closing " (for example:
Odpoví na otázky jako „Mám nápad na SaaS, kde začít?") and change the closing
straight quote to the Czech closing quote „…“ (so it becomes „Mám nápad na SaaS,
kde začít?“ → „Mám nápad na SaaS, kde začít?“ with paired „…“). Apply the same
normalization to the other reported occurrences of mismatched quotes in this
document (the similar user-facing example strings around the other noted
places).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f5eb8d9e-8daf-449e-a09b-fd104ecf387f

📥 Commits

Reviewing files that changed from the base of the PR and between 819d373 and 5f59d0b.

⛔ Files ignored due to path filters (2)
  • website/astro.config.mjs is excluded by !website/**
  • website/src/lib/locales.mjs is excluded by !website/**
📒 Files selected for processing (29)
  • docs/cs/404.md
  • docs/cs/_STYLE_GUIDE.md
  • docs/cs/explanation/advanced-elicitation.md
  • docs/cs/explanation/adversarial-review.md
  • docs/cs/explanation/brainstorming.md
  • docs/cs/explanation/established-projects-faq.md
  • docs/cs/explanation/party-mode.md
  • docs/cs/explanation/preventing-agent-conflicts.md
  • docs/cs/explanation/project-context.md
  • docs/cs/explanation/quick-dev.md
  • docs/cs/explanation/why-solutioning-matters.md
  • docs/cs/how-to/customize-bmad.md
  • docs/cs/how-to/established-projects.md
  • docs/cs/how-to/get-answers-about-bmad.md
  • docs/cs/how-to/install-bmad.md
  • docs/cs/how-to/non-interactive-installation.md
  • docs/cs/how-to/project-context.md
  • docs/cs/how-to/quick-fixes.md
  • docs/cs/how-to/shard-large-documents.md
  • docs/cs/how-to/upgrade-to-v6.md
  • docs/cs/index.md
  • docs/cs/reference/agents.md
  • docs/cs/reference/commands.md
  • docs/cs/reference/core-tools.md
  • docs/cs/reference/modules.md
  • docs/cs/reference/testing.md
  • docs/cs/reference/workflow-map.md
  • docs/cs/roadmap.mdx
  • docs/cs/tutorials/getting-started.md

- Normalize 64 Czech quotation marks to proper „…" pairs across 14 files
- Fix corrupted UTF-8 box-drawing character in upgrade-to-v6.md
- Use relative roadmap link (./roadmap) in index.md for locale consistency
- Fix typo: Podníková → Podniková in modules.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@JakubStejskalCZ
Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 26, 2026

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

♻️ Duplicate comments (2)
docs/cs/tutorials/getting-started.md (1)

36-36: ⚠️ Potential issue | 🟡 Minor

Verify Czech quotation mark consistency.

Ensure user-facing examples use properly paired Czech quotes („…"). Line 36 and similar examples should maintain consistent Czech quotation punctuation throughout.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cs/tutorials/getting-started.md` at line 36, The Czech quotation marks
in the example string "Odpoví na otázky jako „Mám nápad na SaaS, kde začít?“"
are inconsistent; replace the mixed or mispaired quote characters so the phrase
uses a matching Czech opening double quote „ and closing double quote ” (i.e.,
„Mám nápad na SaaS, kde začít?” should be corrected to „Mám nápad na SaaS, kde
začít?“) — update the example text in docs/cs/tutorials/getting-started.md where
the fragment "Odpoví na otázky" appears to ensure all similar examples use the
paired Czech quotes „…“ consistently.
docs/cs/reference/testing.md (1)

45-45: ⚠️ Potential issue | 🟡 Minor

Fix Czech quotation mark pairing.

Line 45 uses an opening Czech quote but the closing punctuation should also be a Czech closing quote " (U+201C) to properly pair with the opening (U+201E). The phrase should read: „jednoduché a udržovatelné"

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cs/reference/testing.md` at line 45, The Czech opening quote „ in the
phrase "Generované testy sledují filozofii „jednoduché a udržovatelné" is not
properly paired; replace the trailing ASCII/incorrect quote after udržovatelné
with the proper Czech closing quote (U+201D) so the phrase reads with matched
quotes (opening U+201E and closing U+201D).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/cs/reference/testing.md`:
- Line 45: The Czech opening quote „ in the phrase "Generované testy sledují
filozofii „jednoduché a udržovatelné" is not properly paired; replace the
trailing ASCII/incorrect quote after udržovatelné with the proper Czech closing
quote (U+201D) so the phrase reads with matched quotes (opening U+201E and
closing U+201D).

In `@docs/cs/tutorials/getting-started.md`:
- Line 36: The Czech quotation marks in the example string "Odpoví na otázky
jako „Mám nápad na SaaS, kde začít?“" are inconsistent; replace the mixed or
mispaired quote characters so the phrase uses a matching Czech opening double
quote „ and closing double quote ” (i.e., „Mám nápad na SaaS, kde začít?” should
be corrected to „Mám nápad na SaaS, kde začít?“) — update the example text in
docs/cs/tutorials/getting-started.md where the fragment "Odpoví na otázky"
appears to ensure all similar examples use the paired Czech quotes „…“
consistently.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: cb1bc449-01a1-4ccd-8f9b-571568f24b48

📥 Commits

Reviewing files that changed from the base of the PR and between 5f59d0b and 6fc599d.

📒 Files selected for processing (16)
  • docs/cs/_STYLE_GUIDE.md
  • docs/cs/explanation/advanced-elicitation.md
  • docs/cs/explanation/adversarial-review.md
  • docs/cs/explanation/established-projects-faq.md
  • docs/cs/explanation/party-mode.md
  • docs/cs/explanation/preventing-agent-conflicts.md
  • docs/cs/explanation/project-context.md
  • docs/cs/how-to/get-answers-about-bmad.md
  • docs/cs/how-to/non-interactive-installation.md
  • docs/cs/how-to/project-context.md
  • docs/cs/how-to/upgrade-to-v6.md
  • docs/cs/index.md
  • docs/cs/reference/core-tools.md
  • docs/cs/reference/modules.md
  • docs/cs/reference/testing.md
  • docs/cs/tutorials/getting-started.md
✅ Files skipped from review due to trivial changes (8)
  • docs/cs/explanation/party-mode.md
  • docs/cs/explanation/preventing-agent-conflicts.md
  • docs/cs/explanation/adversarial-review.md
  • docs/cs/explanation/project-context.md
  • docs/cs/_STYLE_GUIDE.md
  • docs/cs/how-to/non-interactive-installation.md
  • docs/cs/how-to/upgrade-to-v6.md
  • docs/cs/explanation/advanced-elicitation.md

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.

docs(cs): add Czech (Čeština) documentation translation

1 participant