Skip to content

Add README translations (9 languages)#1288

Open
lawrencecchen wants to merge 3 commits intostack-auth:mainfrom
lawrencecchen:feat/readme-translations
Open

Add README translations (9 languages)#1288
lawrencecchen wants to merge 3 commits intostack-auth:mainfrom
lawrencecchen:feat/readme-translations

Conversation

@lawrencecchen
Copy link
Copy Markdown
Contributor

@lawrencecchen lawrencecchen commented Mar 25, 2026

Summary

Adds translated README files with a language selector at the top of each, matching the pattern used by projects like cmux.

Languages (in selector order): English, 繁體中文, 简体中文, 日本語, 한국어, العربية, Bosanski, Dansk, Deutsch, Español, Français, Italiano, Norsk, Polski, Português (Brasil), Русский, ไทย, Tiếng Việt, Türkçe, ភាសាខ្មែរ.

Each translated file includes a disclaimer that the translation was generated by Claude, and that PRs to improve them are welcome.

Files added (19 translations)

  • README.zh-TW.md (Traditional Chinese)
  • README.zh-CN.md (Simplified Chinese)
  • README.ja.md (Japanese)
  • README.ko.md (Korean)
  • README.ar.md (Arabic)
  • README.bs.md (Bosnian)
  • README.da.md (Danish)
  • README.de.md (German)
  • README.es.md (Spanish)
  • README.fr.md (French)
  • README.it.md (Italian)
  • README.no.md (Norwegian)
  • README.pl.md (Polish)
  • README.pt-BR.md (Brazilian Portuguese)
  • README.ru.md (Russian)
  • README.th.md (Thai)
  • README.vi.md (Vietnamese)
  • README.tr.md (Turkish)
  • README.km.md (Khmer)

Changes to existing files

  • README.md: Added language selector line between the header links and the title

Add translated README files with language selector at the top of each:
繁體中文, 简体中文, 日本語, 한국어, Deutsch, Español, Français, Italiano,
Português (Brasil).

Translations were generated by Claude. Each translated file includes a
disclaimer noting this and welcoming PRs to improve them.
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 25, 2026

@lawrencecchen is attempting to deploy a commit to the Stack Auth Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 25, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 23be756d-112c-47ae-afee-a97cd2d62d73

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ 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.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Mar 25, 2026

Greptile Summary

This PR adds nine translated README files (Traditional Chinese, Simplified Chinese, Japanese, Korean, German, Spanish, French, Italian, and Brazilian Portuguese) and updates the main README.md with a language selector. Each translation is a comprehensive, well-structured Claude-generated version of the full English README, complete with an AI-translation disclaimer and a consistent language selector at the top.

  • All 9 translated files are complete and cover every section of the original README (features table, installation, community projects, development setup, and useful commands).
  • Language selectors in each file correctly highlight the current language as plain text and link all others — navigation between files is properly symmetric.
  • README.zh-CN.md and README.zh-TW.md incidentally fix a pre-existing <h3>/</h4> tag mismatch from the original README.md (using the correct </h3>), while the other 7 translated files reproduce the original's mismatched closing tag — creating a minor inconsistency between the translated files themselves.
  • The contrib.rocks contributors image URL (repo=stack-auth/stack) is copied faithfully from the original README.md across all translations — this is a pre-existing issue not introduced by this PR.

Confidence Score: 5/5

  • This is a documentation-only PR with no functional code changes; it is safe to merge.
  • All changes are Markdown documentation files. Translations are comprehensive, well-organized, and consistent with the original. The only finding is a minor heading tag inconsistency between two Chinese files (correct </h3>) and the remaining seven translated files (mismatched </h4>), which mirrors a pre-existing issue in the original README and has no rendering impact in practice.
  • No files require special attention.

Important Files Changed

Filename Overview
README.md Adds a language selector <p align="center"> block between the header nav links and the title. Clean, minimal change.
README.de.md New German translation. Well-structured and comprehensive. Uses mismatched </h4> closing tag (copied from original README) instead of correct </h3>, unlike the zh-CN/zh-TW translations.
README.zh-CN.md New Simplified Chinese translation. Correctly uses matching </h3> closing tag, unlike the original README.md and 7 other translations which use </h4>.
README.zh-TW.md New Traditional Chinese translation. Correctly uses matching </h3> closing tag, unlike the original README.md and 7 other translations which use </h4>.
README.ja.md New Japanese translation. Well-structured with accurate translations. Uses mismatched </h4> closing tag consistent with original README.md.
README.ko.md New Korean translation. Well-structured and comprehensive. Uses mismatched </h4> closing tag consistent with original README.md.
README.es.md New Spanish translation. Well-structured with accurate translations.
README.fr.md New French translation. Well-structured with accurate translations.
README.it.md New Italian translation. Well-structured with accurate translations.
README.pt-BR.md New Brazilian Portuguese translation. Well-structured with accurate translations.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[README.md\nEnglish] --> B{Language Selector}
    B --> C[README.zh-TW.md\n繁體中文]
    B --> D[README.zh-CN.md\n简体中文]
    B --> E[README.ja.md\n日本語]
    B --> F[README.ko.md\n한국어]
    B --> G[README.de.md\nDeutsch]
    B --> H[README.es.md\nEspañol]
    B --> I[README.fr.md\nFrançais]
    B --> J[README.it.md\nItaliano]
    B --> K[README.pt-BR.md\nPortuguês Brasil]

    C <-->|cross-links| D
    C <-->|cross-links| E
    D <-->|cross-links| F
Loading

Reviews (1): Last reviewed commit: "Add README translations for 9 languages" | Re-trigger Greptile

<a href="README.md">English</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | Deutsch | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (Brasil)</a>
</p>

# Stack Auth: Die Open-Source-Authentifizierungsplattform
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.

P2 Inconsistent heading tag across translated files

The navigation header in README.de.md, README.es.md, README.fr.md, README.it.md, README.ja.md, README.ko.md, and README.pt-BR.md uses a mismatched <h3> opening with </h4> closing, copied from the original README.md:

<h3 align="center">
  ...
</h4>

Interestingly, README.zh-CN.md and README.zh-TW.md use the correct matching </h3> closing tag. While the mismatch is pre-existing in the original README.md and doesn't affect rendering in most Markdown renderers, the seven files above are inconsistent with their two sibling translation files. It would be worth either:

  • Aligning all translated files to use the correct </h3>, or
  • Filing a follow-up to fix the original README.md as well

This inconsistency also appears at the same location in: README.es.md:16, README.fr.md:16, README.it.md:16, README.ja.md:16, README.ko.md:16, README.pt-BR.md:16.

lawrencecchen and others added 2 commits March 24, 2026 21:11
New languages: العربية, Bosanski, Dansk, Norsk, Polski, Русский, ไทย,
Tiếng Việt, Türkçe, ភាសាខ្មែរ.

Updated language selector in all existing files to include all 19
translations.
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