バージョン管理システム利用指針¶
方針¶
ブランチ数を最小にする
作業単位で情報が分散しないようにする(凝集度を高める)
作業状況をわかりやすくする(チェックボックスにて進捗を管理する)
ブランチ一覧¶
- master
少なくとも、査読、日本語警察実施済みの成果物を配置する
- [翻訳範囲を示すブランチ]
該当範囲の翻訳、査読、日本語警察作業を行うため、masterから作成されるブランチで、作業後masterにマージされる
ブランチ名は、[a-zA-Z_0-9]からなる文字列で命名する
Tutorialの場合 : tutorial[番号]_[タイトル]_[lesson][最初の番号]_[最後の番号]
Lectureの場合 : lecture[番号]_[タイトル]
- user_[ユーザレビュー範囲を示すブランチ]
ユーザレビューで変更が必要な場合、masterから作成されるブランチで、作業後masterにマージされる
[ユーザレビュー範囲を示すブランチ]は、[翻訳範囲を示すブランチ]に準拠する
作業の流れ¶
1〜4に 役割 2 を分けて作業を進める。但し、各作業フェーズに特化しない全体的な課題はIssueを作成して解決する。
翻訳(詳細はGitHub Wiki 3 を参照)
翻訳範囲を示すブランチを作成する
(空)コミットを行う
masterブランチに対し、Draft PR(Pull Request)を発行する
チェックボックスにて、作業進捗が分かるようにする
作成したブランチに翻訳コミットを追加していき翻訳を終わらせる
翻訳作業が終わったら、Draft PRをPRに変更し、PR上でReviewersに査読メンバーを追加した上で@mentionで通知する
査読
PRに対して、コメントを記載していき査読を終わらせる
PRのFiles changedタブで差分を開き+アイコンをクリックしてコメントを追記
必要に応じて、翻訳者と連絡を取り合い査読を終わらせる
査読が完了したら、PR上でReviewersに日本語警察メンバーを追加した上で@mentionで通知する
日本語警察
PRに対して、コメントを記載していき日本語警察を終わらせる
PRのFiles changedタブで差分を開き+アイコンをクリックしてコメントを追記
必要に応じて、翻訳者と連絡を取り合い日本語警察を終わらせる
日本語警察が完了したら、PRをマージする
ユーザレビュー
翻訳者の依頼を受け、指定された翻訳範囲のユーザレビューを行う
必要に応じて、翻訳者と連絡を取り合いユーザレビューを終わらせる
変更が必要な場合に限り以下を行う
翻訳者がブランチを作成して修正を行い、PR上でReviewersにユーザレビューメンバーを追加した上でPRを発行し、@mentionで通知する
ユーザレビュー担当者が確認を行い、問題なければマージする
脚注