Skip to content

Conversation

@shimotmk
Copy link
Contributor

@shimotmk shimotmk commented May 5, 2025

Motivation for the change, related issues

Related issues #2198

Added a "Contributing to Translations" page and adjusted intro.md.

translations

The Japanese documentation team has a custom of leaving the original text commented out and translating it immediately after.

Example:
https://github.com/jawordpressorg/gutenberg/blob/trunk/docs/README.md?plain=1

This makes it easier to check the differences when the original text is updated.

Command to compare the original text with Japanese

Example: intro.md

diff -y --suppress-common-lines packages/docs/site/docs/main/intro.md packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/intro.md

When I put a comment out at the beginning of the md file, the Markdown title was rendered.
Therefore, I wrote the translated language first, and then the original text.

before after
root-before-s root-after-s

If this method works, I would like to contact the Japanese documentation team and increase the number of translated pages of the Japanese documentation.

@adamziel
Copy link
Collaborator

adamziel commented May 6, 2025

Let's see if the method works!

@adamziel adamziel merged commit 43f0228 into WordPress:trunk May 6, 2025
8 of 9 checks passed
@github-project-automation github-project-automation bot moved this from Inbox to Done in Playground Board May 6, 2025
@shimotmk
Copy link
Contributor Author

shimotmk commented May 6, 2025

Thanks for the review 🙌
It works fine!
https://wordpress.github.io/wordpress-playground/ja/contributing/translations

@shimotmk shimotmk deleted the docs/i18n-ja-translations branch May 6, 2025 20:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

No open projects
Archived in project

Development

Successfully merging this pull request may close these issues.

2 participants