背景
2年前に関数の説明を読む必要があるとき、Googleを開き、この関数の名前を入力して、php.net Webサイトのロシア語の説明へのリンクをクリックしました。 すぐに説明が間違っていることに気づきました-最近のPHPリリースから遠く離れて追加された3番目のパラメーターは不愉快でした。 肩をすくめて、私は英語版に切り替えました。そこではすべてが正しく、現在の状況と一致していました。
しかし、破片は私の記憶に残り、しばらくして、私は問題を研究し、ドキュメントがどのようにローカライズされているかを正確に調べることにしました。 文字通り、検索結果の3行目は、ハブに関するかなり古い記事につながり、プロジェクトに参加したいという願望がありました。
実際、ロシア語のローカライズが現在どのように行われているか、どのような問題に直面しなければならないか、これらすべてからどのような結論を引き出すことができるかについて、かなり混oticとした話があります。
手始めに、今の状況について。
このプロジェクトでは、変更されたページの更新と校正のモードで1.5人の掘り手が関与しました。 時間の平凡な不足と、おそらく疲労のために、新しいものが翻訳されることはほとんどありません。
12.992から7.147ファイルが翻訳されました。 量では55％ですが、量では67.6％です。 ロシア語のローカライズよりも急で、日本語（63％）、スペイン語（65.5％）、およびフランス語（77.3％）のみです。
しかし、もっと重要なのは、翻訳されたページの100％が関連していることです。
2年前に起こったこと。
この状況は、Irkerの主要なメンテナーの1人のメーリンググループでの私の質問への回答によって最もよく説明されています。
現時点では、ロシア語への翻訳は一時停止中です。実際、ローカライズの状態は次のようになりました
すべてのアクティブな翻訳者が興味を失ったか、その時間を見つけることができません。
（私も含めて）。 そして、何らかの形で興味を示したすべての新しい人々
すぐに消えます=）
申し訳ありませんが、その時点ではスクリーンショットを撮ろうとは思いませんでした。
これについては、おそらく、進捗報告書で、私は終了し、問題について話を続けます。
直面しなければならなかったもの
dr死を救う-dr死の仕事
最初の、そしておそらく最大の問題の1つは、チームコミュニケーションです。
最初の100ページを翻訳してパッチを作成したので、次に何をすべきかわからないことに気付きました。 パッチがフィードバックなしで約2週間待機すると、何かを続けたいという欲求が完全に消えます。 実際、その瞬間、私は100ページが5ページではなく、行われた仕事を捨てることは平凡だったという事実によって救われました。 したがって、すべてのドアをノックすることが決定されました。おそらく誰かが応答するでしょう。
後になって、最も簡単な方法はメーリンググループに書き込むことであることがわかりました（2016年以降は完全に途方もないコミュニケーション方法です）。そのとき、探偵小説を再生し、ニックネームで翻訳者を探して手紙を送る必要がありました。 送られたすべての手紙の中で、答えはIrkerからだけでした 。そして、その瞬間から、すべてをまとめました...
蒸気機関車を出発した後の障害物競走。
新しいページの翻訳を開始する前に、古いページの注文を開始することは論理的でした。 ドキュメントの3分の1が現実と一致しない場合、ドキュメントの価格は価値がありません。 約700ページが整頓されるのを待っていました。 さらに、英語のブランチを更新するプロセスはPHP 7に一致するようになっていたため、その数は増え続けていました。
それは蒸気機関車についてであり、現在は障害物についてでした。
最悪の部分は、これらのページの半分が既に誰かによって試されていたことでした。 多くの場合、これは最後まで行われたのではなく、むしろ曲がっているか、更新後にメインページが数回変更されました。 一般的に、彼はまだアドックです。
そして、スクリプトですべてのドキュメントのインデントを修正しましょうか？
数回、英語のブランチで、スクリプトがすべてのドキュメントですぐに何かを支配するという状況がありました。 通常、翻訳者の自動更新に関する指示は翻訳者の隣にレイアウトされていましたが、実際には、とにかく100〜200ページを手動で調整する必要がありました。 悲しいが本当。
私は何かを押して、それはすべて壊れました
最も不快なイベントの1つは、メーリングリストで手紙を受け取ることです。
PHPマニュアルのruビルドは壊れているため、検証もビルドもされません。 修正してください！ ;）1つのファイルの朝のコミット後にイブニングビルドが壊れた場合、ほとんどの場合、すべてが簡単です-確認してください。 ただし、コミットが20回あり、ファイルの数が数百で測定されている場合、添付されたログと診断モードの両方が問題の場所の理解を常に追加するわけではないため、自分でハングアップする方が簡単です。 また、問題は英語の主要な支社の側に簡単にあり、死体は一般的に軽いです。
添付は完全なログです
愛、docs.php.netサーバー
...
ええ男。 心配ありません。 ハップ・シッテン。 上記のエラーを修正してからもう一度お試しください。
==============>スナップショットを撮るときに何かが起こった
完全に失敗しました
===============>ご覧ください！
そして、地球の表面から彼の創造物を一掃しました-簡単、簡単、インスピレーション付き。
破壊者。 はい 幸いなことに、それは可能な限りではありませんが、単純な「x * x x * x X * y was Vasya here」からフィッシングサイトへのなりすましリンクで終わるすべてから定期的にstable舎を一掃する必要があります。
フィンランド語を学びましたか？
用語は依然として頭痛の種です。 多くの英語の用語では、ロシア語には平凡な類似語はありません。 そして、原則として英語でさえ適切な説明が存在しない狭い専門的な拡張機能を記述することになると、非常に悲しくなります。 1つの小さなページを翻訳するのに、一般的に使用されるものに関する1ダースの大量のテキストよりも数倍時間がかかる場合があります。 一方、あなたは多くを学びます。
結論
- ロシアのPHPドキュメントを使用できます。 これは100％関連性があり、近い将来にそうなります。
- この出版後に突然、逃げ出したい人がいたら、翻訳された記事が増えることさえ期待できます。
参照資料
オンライン編集者
Irkerの著者としてオンラインエディターを使用するための手順
配布グループ
PS：おもしろければ、PHPドキュメントの記述プロセスがどのように機能するのか、何が良いのか、何が良くないのかについて一般的に話すことができます。
1.5掘削機lex111の依頼で 、私はそこに半分います:)
少し前まで、GitHubで、 Gitドキュメントリポジトリを作成しました（svnを使用していること、 Gitへの移行用のチェックリストがあることに注意してください）。誰もが更新を購読できます（[ウォッチ]ボタン）ドキュメンテーションで、または現在のドキュメンテーションの品質が気に入った場合は、アスタリスク（スターボタン）でマークしてください:)。 それで、ドキュメントの改善とさらなる開発に参加してください、あなたは多くの新しくて役に立つことを学びます！
UPD スラックでチャンネルを作成しました。 誰とチャットしたい-入って来い