議事録をGitLab で管理するとこうなった

Posted at 2018-12-03

議事録ってどうやって作成・管理してますか？
だいたい、以下のような感じだと思います。

これに GitLab を使ってみると割と便利だったので紹介します。

1. 会議中にメモを取る

ここは、今まで通り頑張ってください。。。
あえて、GitLabに絡めるなら、GitLab のWeb IDEで作成していくとか。。

Markdown、AsciiDocのようなGitLabでプレビューがサポートされている形式で書きましょう。
それを GitLabのレポジトリで、新規ブランチを作成し、作成した議事録を追加します。

議事録のフォーマットがあるなら、それも一緒にレポジトリに入れておきましょう。

ここからが、GitLab で議事録管理するうえでの肝の部分です。

参加者への確認依頼をMerge Request(MR)で出します。
そして、この際、以下のルールを決めておきます。

通常のMRのように該当箇所にコメントをつけてもらいます。
こうすることで、全ての人の指摘が一箇所で確認できます。
メールでの回覧レビューだと各々が返信してくるので複数のメールをみて統合する作業が必要になってきますが、これだとその作業から解消されます。

また、レビュアーはコメントをするときに、他の人のコメントがすぐ目につくので、指摘が食い違う場合は、指摘者同士で議論してくれます。もう、板挟みからおさらばです

確認が終わったことがわかるアクションを決めておきましょう。

例えば

こうすることで、指摘が完了したことをきちんと把握できます。

ちなみに、GitLab EEなら、MR時に必要な承認者を設定できる機能がある模様 Merge request approvals

GitLab のIssue を作成し、かつこのMRとの関連をつけるようにします
（MRの reference をIssueに記載するだけで、双方向から辿れるようになります）。

これにより、次回の会議時に、宿題の結果や進捗の確認が容易です。
IssueからMRに飛ぶこともできるので、後から見た時に元の議事録を確認でき、宿題がでた経緯がすぐわかるようになります。

指摘が完了したことを確認できたら、マージボタンをクリックします。

上記の運用の場合、全てGitLabのUI上で完結できるので、「Gitなにそれ？」の人でも大丈夫です。