.
├── .github
│ ├── workflows
│ │ ├── assign-pr-reviewers.yml # レビュアー割り当てを決める
│ │ ├── check_directory_name.yml # ディレクトリ名チェック
│ │ ├── checker.yml # コードチェック
│ │ ├── final_message.yml # PR内の最後のメッセージ
│ │ ├── first_message.yml # PR内の最初のメッセージ
│ │ └── set-pr-reviewers.yml # 割り当てたレビュアーを実際に指名する
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── labeler.yml # 何回目の課題かを判別する用
├── ci
│ ├── assign_reviewers.py # assign-pr-reviewersのworkflowで実行されるスクリプト
│ └── users.csv # 輪講参加者と割り当て情報を格納
├── docs
├── README.md
├── ex1
└── ...- 以下の箇所を変更する
- ドキュメントの各リンクが有効か確認する．
- users.csvの更新
- Setting > Collaboraters and teams > Manage Access からB4輪講参加者全員をWrite権限で追加しておく．これをしないと，workflowが実行された時に
Error: Resource not accessible by integrationというエラーが発生する可能性がある．
どのディレクトリに対してpushしているかによって異なるラベルを付与される．レビュアー割り当てで利用される．
ラベルをまとめて作成するスクリプトは以下の通りである．
label_name=("EX1" "EX2" "EX3" "EX4" "EX5" "EX6" "EX7" "EX8" "EX9" "assignment" "auto-pr")
color=("3366CC" "DC3912" "FFA500" "109618" "990099" "AFEEEE" "DD4477" "BCBD22" "B82E2E" "316395" "f2cf01")
for idx in ${!label_name[@]}
do
gh label create ${label_name[idx]} --color ${color[idx]} -R TakedaLab/B4Lecture-XXXX
doneスクリプト内の色は以下の通りである．
#3366CC
#DC3912
#FFA500
#109618
#990099
#AFEEEE
#DD4477
#BCBD22
#B82E2E
#316395
#f2cf01
users.csvを準備する．以下のように4列で書く．最後は空行にすること． 外部からのM1は必ずしも課題を解くわけではなくイレギュラーなので，ここには入れず別で（手動での割り当て等）対応するのが良い．
- 1列目：各自のgithubのアカウント名
- 2列目：学年（参考程度であり，プログラムでは使われない）
- 3列目：グループ（受講生はstudentとする．その他は任意の名前でOK．それぞれのグループから各PRにレビュアーを1人ずつ選抜する．student, reviewer1, reviewer2などのようにstudent以外はいくつでもグループを作れる．ただし，student以外の各グループの人数は，studentの人数より多くなるようにしなければならない．）
- 4列目：研究室名（参考程度であり，プログラムでは使われない）
github_account,position,group,laboratory
<account1>,b4,student,takeda-lab
<account2>,b4,student,toda-lab
<account3>,b4,student,toda-lab
...
<accountY>,m2,reviewer,takeda-lab
<accountZ>,m2,reviewer,takeda-lab
（空白）
割り当てのステップは2段階ある．
- 割り当てを決定しusers.csvに書き込む（手動）
各課題を発表するあたりで実行する．手動といってもブラウザ上でボタンを押していくだけである．
Actions > Assign PR Reviewers > Run workflow から実行する．
これによりPRが作成される．users.csvの新たな列に次の課題のレビュアー割り当てが追加される．問題なければマージする．
- github_account,position,group,laboratory
- <account1>,b4,student,takeda-lab
- <account2>,b4,student,toda-lab
- <account3>,b4,student,toda-lab
- ...
- <accountY>,m2,reviewer,takeda-lab
- <accountX>,m2,reviewer,takeda-lab
+ github_account,position,group,laboratory,EX1
+ <account1>,b4,student,takeda-lab,<account3>
+ <account2>,b4,student,toda-lab,<account4>
+ <account3>,b4,student,toda-lab,<account1>
+ ...
+ <accountY>,m2,reviewer,takeda-lab,Unassigned
+ <accountZ>,m2,reviewer,takeda-lab,<account1>
（空白）- PRに対してレビュアーを設定する（自動）
1でマージすることで，その後作成されたPRに対してusers.csvの情報に基づいてレビュアーが指名される．どの課題かはラベルから判断される．
デフォルトではCIチェックを通らずともマージが可能である．これはGithubのリポジトリ設定から変更できる．
また，flake8などのlinter，formatterの項目も自由に設定できる．CIのymlファイルの内容を変更することで反映できる．
masterにマージする場合，間違えて操作しないように保護するのがオススメ．これもGithubのリポジトリ設定から変更できる．
例） レビュアー1人からapproveされないとマージできないようにする
- workflowはメインブランチがmasterであることを想定して作成されている．