オープンソースドキュメント翻訳プラットフォームとしての GitHub (React 日本語ドキュメントの例)

はじめに ひょんなことから React 公式ドキュメント日本語版のメンテナをやらせていただいています smikitky です。 この記事は、React 公式ドキュメントの翻訳作業が GitHub ベースでどのように行われているのかを解説したものです。ドキュメントの翻訳には色々な方法がありますが、React の現アプローチは非常に上手く行っていると個人的に考えています。部分的には似たアプローチを説明している既存記事も探せばありますが、少し詳しめに書くことで事前の不安を取り除き、「思ったより簡単そうだから、自分もあのライブラリのドキュメント翻訳をやってオープンソースに貢献してみよう」と思えるようになることを目標にしています。 想定読者は Git、GitHub、Markdown（ないし類似の軽量マークアップ言語）、および基本的な HTML の仕組みがわかる開発者です。何らかの静的サイトジェネレー

[rin51]

英語の原文を git merge してもよきにはからってくれるだと...

[inductor]

Kubernetesのドキュメント当初はForkでやってたけど今はUpstreamに取り込むようにしてる。でもバージョンのライフサイクルが早すぎて最新に追従するのは人数的にも難しい・・・。

[kako-jun]

翻訳で貢献したくても、.poファイルを編集するルールが面倒でやめたことがあるので、これは素晴らしい。さすV（さすがVue）

[efcl]

Reactのドキュメントの翻訳フロー。 ドキュメントをforkし、upstreamを取得してconflict marker付きでコミットしたものに翻訳を当てていく。

[ledsun]

“一旦ブランチ上でコンフリクトマーカーごとコミットしてしまうというのがミソです。チェックアウトした時点で既にコンフリクトマーカー付きというのは、ちょっとタブー感あって自分には思いつかない発想です”

[jay-es]

そういえば今までに翻訳で参加したプロジェクトは全部 GitHub だな

[dh16t]

翻訳ソリューションの機能が使えないつらみがありそうだけど、VSCodeで何とでもなりそうな感じもある。