Slack, GitHubをスムーズに使う為に

配布用です

Transcript

1. Slack, GitHubを スムーズに使う為に by @yuuhanasaki39 2021/04/29 ゆるい勉強会 in Hakodate
2. B3 ICTコース @yuuhanasaki39
3. GitHub Slack 両ツールを使う上で起こりうる問題を考える
4. Slack 起こりうること - 書き込む場所に悩む - 目的のチャンネルを探してさまよう - 権限が必要だが管理者が誰かわからない
5. GitHub 起こりうること - ブランチ上手く切れない - issueの情報量がない - そもそも何したらいいか分からない
6. 見やすくしたい まずどちらも、、、 視覚的に分かりにくいのが問題
7. 規則を決めておこう 見やすくするために、、、
8. Slack編
9. 規則を決めておく ｜Slack - チャンネル名 - ユーザー名 - 権限の範囲(管理者向け)
10. カオスな チャンネルの例
11. わかりやすいチャンネル名をつける 規則を決めておく ｜チャンネル名 チャットする場所に迷わないために 対象と目的を含んだ名前
12. 規則を決めておく ｜チャンネル名 詳細：メルカリ流！Slackチャンネル命名ルールを紹介します #team3-random チャンネル名構成 #[対象]-[目的] 例
13. 対象をわかり易く - チームを示す： #team0-[目的] - 一時的な用途： #tmp-[目的] - 趣味, 個人： #z-[目的], #zp-[目的] (表示順を考慮) 規則を決めておく ｜チャンネル名 詳細：メルカリ流！Slackチャンネル命名ルールを紹介します
14. 目的を分かり易く - チーム内での会話・雑談：#[対象]-random - 依頼を受付：#[対象]-req 規則を決めておく ｜チャンネル名 詳細：メルカリ流！Slackチャンネル命名ルールを紹介します
15. 所属を分かり易く - 学籍番号 - 役割担当 - グループ 規則を決めておく ｜ユーザー名
16. 規則を決めておく(管理者向け)｜権限の範囲 誰かが抜けても困らないように - チームリーダーにAdmin - 必要に応じて増やす - wikiかロールに権限を書いておく 詳細：Slack での各メンバー種別の権限
17. 個人的に面白いと思った使用例 余談1
18. 画像元：「脱出チャンネル」/ GMOペパボ 該当者をタスク用チャンネルに招待し、完了したら抜ける
19. Slashコマンド 余談2
20. テキストバーで ”/” 覚えておくと前より少し楽に使える ...かもしれない
21. 詳細： Slack のスラッシュコマンド
22. GitHub編
23. 規則を決めておく ｜GitHub - ブランチ名 - ブランチ保護(管理者向け) - issue(管理者向け)
24. 規則を決めておく ｜ブランチ名 詳細：複数人開発の際には Gitのワークフロー、GitFlowとGitHub Flow を導入すると便利です 用途と管理者を明らかにする - 機能実装は”feature/日付/名前/機能名” - バグ修正は”fix/日付/名前/機能名”
25. 規則を決めておく(管理者向け)｜ブランチ保護 詳細：複数人開発の際には Gitのワークフロー、GitFlowとGitHub Flow を導入すると便利です 他メンバーの作業履歴を守る - git push -f の禁止 - pull requestのレビューを強制 ブランチルールを設定する
26. ブランチ規則は”Settings”から設定できる
27. 規則を決めておく(管理者向け)｜issue 詳細：オレオレ GitHub Issue テンプレートを晒す issueテンプレートを使う - 情報の漏れを作らない - 素早くissueを立てられる
28. 画像元：学内離着席管理アプリ ’RALAF’ - GitHub テンプレート設定後に”new issue”を押すとこのように出る
29. 規則を決めておく(管理者向け)｜issue 詳細：オレオレ GitHub Issue テンプレートを晒す バグの場合 - 不具合の内容 - 発生手順 - 動作環境 機能要望 - 概要 - 理想動作 - 理由 - 実装方法 - 参考URL
30. これまでに決めた規則は 　　　　　　　wikiにまとめておこう
31. 画像元：学内離着席管理アプリ ’RALAF’開発wiki 実際に規則をwikiにまとめた例
32. wikiの活用 wikiに書き足すべきこと - 導入手順（環境構築） - 用語集
33. wikiの活用 ｜導入手順（環境構築） 同じ開発環境を再現できるようにする スムーズに開発を始められるように、 　実行した操作をスクリーンショット, 　　参考URLなど含めて詳細に載せておく 参考：ローカル開発環境の必要性について
34. 画像元：学内離着席管理アプリ ’RALAF’開発wiki 実際の開発で使われているwikiの例
35. wikiの活用 ｜用語集（必要があれば） 定義を共有する 開発で扱う用語のうち, 誤解を生むもの, 調べた用語の定義を書いておく
36. 規則を決めてスムーズに使おう まとめ
38. 勉強会するかわからないので紹介だけ （使いそうだったら詳しく書きます）
39. Trello … タスク管理ツール デメリット - GitHub Projects で済む場合有 メリット - 進行が視覚的に埋もれない - 非エンジニアが使える - 学習コストが低い
40. GitHub Projects Trello タスク管理ツール比較 - issueベースの開発 - プログラマの割合が多い など - 大きなタスク進行 - 非プログラマの割合が多い など
41. GitHubのissueと 連携できるらしい