第19回岡山Ruby，Ruby on Rails勉強会の発表スライドです．

1. RubyでGitHubを
もうちょっと便利にする
2016年2月27日
第19回 岡山Ruby, Ruby on Rails勉強会
小林寛明 岡田卓也
岡山大学 工学部 情報系学科 乃村研究室

2. 乃村研の紹介
• 岡山大学乃村研究室の小林寛明と岡田卓也です
• Railsで複数のプロジェクトを開発
• camome: メールの再利用支援システム
• nomnichi: 研究室ホームページシステム
• octaccord: GitHub issueを扱うCLI
• 第16回で紹介: RubyでGitHubをちょっと便利にする
• コードとタスク管理にGitHubを利用してます！
• https://github.com/nomlab
2

3. 今までの開発体制
3
議事録作成：Redmine タスク管理：Redmine コード管理：GitHub
Link Link
(手順1) Redmineで議事録作成
(手順2) Redmineでチケット(タスク)を作成
(手順3) チケットに関するコードをGitHubにpush

4. GitHubで一括管理したい
しかし…
• Wikiの議事録にissueと同じ事を書くのは面倒
• issueの優先順位の管理が出来ない
• 議論の対象となるissueの検索がしづらい
（Redmineは強力なチケット検索機能があった）
4
issueベースの開発を支援するoctaccordを作成！

5. octaccord導入後の開発体制
5
(手順1) GitHub(issue)に議事内容を記録
(手順2) octaccordでGitHub wikiに議事録を自動生成
(手順3) issueに関するコードをGitHubにpush
議事録作成：GitHub wiki タスク管理：GitHub コード管理：GitHub
Link Link

6. 使ってみたけど…
• issueから議論内容を生成するのは難しい
• 本来，issueは議論の結果生まれるもの
• 議論をしながらissueを作成するのが大変
• 議事録になることを意識して作る必要がある
• 議論に集中できない
6
やっぱり議事録ベースで開発したい！

7. jay つくってみた
デモをご覧ください
7

8. jay
• jay(カケス)は食べ物を集めて蓄える鳥
• 情報を集めて蓄える議事録を管理
• Railsで実装
• 機能
• 拡張Markdownで議事録作成
• 議事内容からissueの生成
• issueと議事録の関連付け
8
議事録ベースでの開発を支援！！

9. 箇条書きの拡張
• “*” : 通常の箇条書き(ビュレット)
• “+” : 項番付き箇条書き
• CSSに頼らないため，コピー&ペースト可能
9
Before: After:

10. クロスリファレンス
• “<<name>>”: ラベル
• “[[name]]”: ラベルに対する参照
• 後方参照も可能
10
Before: After:

11. 議事内容からissueの生成
1. issueにしたい部分を範囲選択
11

12. 議事内容からissueの生成
2. 議事録の宿題リンクをクリック
12

13. 議事内容からissueの生成
3. issueを半自動的に生成
13

14. issueと議事録の関連付け
1. 議事録の宿題リンクをクリック
14

15. issueと議事録の関連付け
2. GitHubのissueが開く
3. issueのリンクをクリック
15

16. issueと議事録の関連付け
4. 議事録の該当箇所までスクロール&ハイライト
16

17. おわりに
• https://github.com/nomlab/jay で公開中！
• ぜひご利用を！
• そしてぜひPull requestを！
17