Jekyllドキュメントの日本語翻訳リポジトリ「jekyllrb.com.jp」を作成しました

あらすじ

Jekyll プロジェクトに対していろいろやった。

Jekyll プロジェクトのリポジトリルートにある README.markdown と CONTRIBUTING.markdown を日本語訳してプルリクした！
人生初のプルリクエストをささげ、マージしてもらえた。やった！
いきなりカットインしてきた PR に対してすごく親身に対応してもらえた
あわせて Jekyllドキュメントの日本語翻訳リポジトリを作成した！
手伝ってくれる人募集中です！お願いします！
推敲、翻訳してくれる人の募集(切実) · Issue #14 · gosyujin/jekyllrb.com.jp

今回のやり取りを通じて、ドキュメントに対して以下のような観点で考える力が足りないと感じた。

まだ明確な答えは出ていないので、これからドキュメントを育てつつ答えを探していきたい。

意訳 or 直訳？
若干意味が通らない文章になってもいいから、出てくる単語を全て愚直に訳す？
経験(実際にライブラリを使うと、「このコマンドはこう動くから、この文章ではこう言いたいのだろう」的なニュアンスはわかったりする)をもとに意訳する？
- 前者だと文章がごちゃっとなりそうで、後者だと大事な表現を落としてしまう事が多そう
- 他プロジェクトなどで翻訳された文章を読んでいると、前者が多いような気がする…
- もちろんおそろしくカッコよくて読みやすい文章に訳せるならば、それに越したことはない
原文はどうしよう？
原文(英語)の扱い
- 残す？残さない？また、残す場合はコメントアウト？
- 文章を比較する場合や本家の更新に追従する場合、原文がないとわけわからなくならない？ diff とかとるのに
本家への追従の仕方
- 本家のドキュメントにどうやってついていく？
誰が、どこで、どう管理するか？
Author と Committer が読めない(管理できない)ブツはどのように管理すべきなのか
- 本家のリポジトリに jp とか en みたいにディレクトリ切ってそこで管理していく
- 翻訳したドキュメントは、その言語を取り扱える別の人が所有し、本家はそこをフォークしておく

この辺、他のプロジェクトではどうやっているんだろう。

以下、おまけ。

いかにして Jekyll にプルリクするに至ったかの経緯。

翻訳できた
自分で翻訳した CONTRIBUTING.markdown を読みながら Jekyll へのコントリビュートのやり方を確認
「文章の更新」については書いてるけど、新規文書の追加の仕方は書いてないな…
ええいままよで、わからないことは質問してみよう Translated of README.markdown and CONTRIBUTING.markdown into Japanese. by gosyujin · Pull Request #2081 · jekyll/jekyll · GitHub
マージされた！

次に、 Jekyll ドキュメントの翻訳リポジトリを作るに至ったかの経緯。

上記のプルリクエストが close された後もやりとりを…。

docs 下の翻訳もしたいが、どこにどういうファイル名で置けば良い？
我々は日本語の読み書きができないから確認ができない
メンテナンス性も下がるから、できるだけ(オリジナル以外の)ドキュメントを管理したくない
「@matheus が自分のリポジトリを作ってやってるから参考にしてみて」
- ※ @matheus さんはブラジルドメインでポルトガル翻訳(？)をやっている模様

とのこと。言ってることはごもっとも。どう管理するのが一番良いんだろう？

結局、翻訳サイトは(上記の jekyllrb.com.br も含めて) Jekyll 本家からフォークして参照するのが一番良いのではないかという意見もあり。

やるならリポジトリを作ってそこでやってみたらどうかと助言をいただく。

というわけで始動させてみました！よろしくお願いします！