From fcc7fbbda957f99facbaeb5fa01291707529b130 Mon Sep 17 00:00:00 2001 From: John Banister Date: Mon, 18 May 2026 08:27:24 -0700 Subject: [PATCH] docs(contributing): Add Internationalization section pointing at #594 Translation support is post-1.0; the section sets expectations and routes would-be translators to Discussion #594 (the central tracking thread for framework choice, string extraction, and translator workflow) rather than duplicating that scope here. Also asks contributors not to open framework or string-extraction PRs ahead of the design conversation, so the eventual implementation stays consistent across languages. --- CONTRIBUTING.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f7efdb6f..e8b9c694 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,6 +12,7 @@ Thank you for your interest in contributing to Charted Roots! This document prov - [Coding Standards](#coding-standards) - [Testing](#testing) - [Documentation](#documentation) +- [Internationalization](#internationalization) - [Submitting Changes](#submitting-changes) - [Security](#security) @@ -335,6 +336,25 @@ Follow the [Documentation Style Guide](docs/assets/templates/documentation-style - **API Reference**: Public API documentation - **Tutorials**: Step-by-step walkthroughs +## Internationalization + +Translation support is **post-1.0** — the UI surface is still being +stabilized for the 1.0 release, and starting infrastructure work now +would compound rework as strings continue to change. + +The central tracking thread is +[Discussion #594](https://github.com/banisterious/obsidian-charted-roots/discussions/594), +which covers framework choice, string extraction, locale detection, +and the translator workflow. If you'd like to translate Charted Roots +into your language, **comment on the discussion** with the language +code (e.g., `zh-CN`, `de`, `fr`) and a brief intro. You'll be +@-mentioned once the infrastructure is ready for translation work. + +Please do not open PRs that add a translation framework or extract +strings ahead of the design conversation — coordinate in +[#594](https://github.com/banisterious/obsidian-charted-roots/discussions/594) +first so the eventual implementation is consistent across languages. + ## Submitting Changes ### Before Submitting