diff --git a/content/en/docs/contributing/localization.md b/content/en/docs/contributing/localization.md index 2d9d2e55673e..615669b7ef09 100644 --- a/content/en/docs/contributing/localization.md +++ b/content/en/docs/contributing/localization.md @@ -235,22 +235,30 @@ For more details about the script, run `npm run check:i18n -- -h`. To start a new localization for the OpenTelemetry website, [raise an issue](https://github.com/open-telemetry/opentelemetry.io/issues/) to share your interest to contribute. Tag all other individuals that are willing to -write and review translations in the language you want to add. You need at least -two potential contributors, three would be ideal. Include the following task +write and review translations in the language you want to add. **You need at +least two potential contributors**, ideally three. Include the following task list in your issue as well: ```markdown -- [ ] List at least 2 contributors for the new language: `<@gitHubHandle1>`, - `<@gitHubHandle2>`, ... -- [ ] Localize index page to `` -- [ ] Create an issue label for `lang:` -- [ ] Create org-level group for `` approvers -- [ ] Update components owners for `content/` +- [ ] Contributors for the new language: @GITHUB_HANDLE1, @GITHUB_HANDLE2, ... +- [ ] Localize site homepage to YOUR_LANGUAGE_NAME +- [ ] Create an issue label for `lang:LANG_ID` +- [ ] Create org-level group for `LANG_ID` approvers +- [ ] Update components owners for `content/LANG_ID` +- [ ] Set up spell checking, if a cSpell dictionary is available ``` -For the `` use the -[ISO 639-1 code](https://en.wikipedia.org/wiki/ISO_639-1) for the language you -want to add. +Notes: + +- For `LANG_ID`, use an official + [ISO 639-1 code](https://en.wikipedia.org/wiki/ISO_639-1) for the language you + want to add. +- Look for + [cSpell dictionaries](https://github.com/streetsidesoftware/cspell-dicts) + available as NPM packages + [@cspell/dict-LANG_ID](https://www.npmjs.com/search?q=%40cspell%2Fdict). If a + dictionary isn't available for your dialect or region, choose the closest + region. For an example of how to set this up, see [PR #5386]. After you created that issue and have the required amount of contributors, maintainers will ask you to provide a pull request with a translation of the @@ -279,3 +287,4 @@ if you are an approver already. [main]: https://github.com/open-telemetry/opentelemetry.io/commits/main/ [multilingual framework]: https://gohugo.io/content-management/multilingual/ +[PR #5386]: https://github.com/open-telemetry/opentelemetry.io/pull/5386/files diff --git a/static/refcache.json b/static/refcache.json index 441cd85be88e..3ca2176ed8e5 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -7271,6 +7271,10 @@ "StatusCode": 200, "LastSeen": "2024-01-30T15:26:01.154768-05:00" }, + "https://github.com/open-telemetry/opentelemetry.io/pull/5386/files": { + "StatusCode": 200, + "LastSeen": "2024-11-02T12:26:48.450866-04:00" + }, "https://github.com/open-telemetry/opentelemetry.io/pulls": { "StatusCode": 200, "LastSeen": "2024-01-30T16:15:25.833527-05:00" @@ -7843,6 +7847,10 @@ "StatusCode": 200, "LastSeen": "2024-02-15T11:30:50.628118+01:00" }, + "https://github.com/streetsidesoftware/cspell-dicts": { + "StatusCode": 200, + "LastSeen": "2024-11-02T12:26:45.305184-04:00" + }, "https://github.com/strimzi": { "StatusCode": 200, "LastSeen": "2024-01-18T20:05:40.859417-05:00" @@ -13403,6 +13411,10 @@ "StatusCode": 200, "LastSeen": "2024-01-18T19:55:41.775458-05:00" }, + "https://www.npmjs.com/search": { + "StatusCode": 200, + "LastSeen": "2024-11-02T12:26:46.909401-04:00" + }, "https://www.nuget.org/packages/": { "StatusCode": 200, "LastSeen": "2024-01-30T15:25:18.124486-05:00"