Page History

ドキュメントビルド時(make html)に、

追加のWARNINGメッセージが出ていないことを確認する

自身の編集作業によって新たに発生したWARNINGはできる限り無くなるように対応してください。

　- WARNINGを確認することで、特にrstファイルについて、デッドリンク含めたフォーマットミスはある程度気付くことができます。

　- 些細なものもありますが全体数を増やさないことが、他のコントリビュータが自身の追加したWARNINGに気付くのを助け、全体の品質維持につながります。

※注意事項: 数件のWARNINGは本家から引き継いで発生していますので（後述のWARNING一覧参照）、これらは無視してください。

ビルド後に、自身が翻訳したページについてブラウザ等で参照し、

フォーマット崩れがないことを一通り確認する

• rst 形式の場合、インラインマークアップの前後に全角文字が隣接する場合、空白を入れる必要がありますが、それが漏れてフォーマットが崩れてしまうことがよくあります。
• markdown 形式の場合、全角文字が隣接していてもきちんとマークアップされるようです (「あああ**強調**いいい」などでよいです)。

• 文章中のリンク箇所については一通り実際にリンク先への遷移まで確認することが望ましいです。

1ファイルの翻訳につき1 commitとなっていること

レビューを受けて修正した場合でも、原則的にcommitは1つにまとめる。複数ファイルを翻訳した場合には、ファイルごとに別commitとする。

ただし、同様の修正を複数のファイルにわたって行う場合 (アンカーの修正など) などはこの限りでない。