伝わらない Issue の書き方

GitHub Issue などの書き方バッドプラクティス

Transcript

1. 伝わらない Issue の書き方 @zaru
2. Issue イズ 何？
3. Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード（ToDo リスト）ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの＝議論する • プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
4. 伝わらない Issue の書き方とは
5. 「ここ直しておいてください」と 口頭で　お願いする
6. タイトルだけの Issue
7. 背景が書かれていない
8. 希望スケジュール　が曖昧
9. なぜか偉そうな物言い
10. URLや再現方法　の 記載がない不具合報告
11. 見た目に依存するのに スクリーンショットがなく 言葉で説明されている
12. 複数の Issue が一つになってる
13. 仮説と計測条件のない施策
14. 用語がチーム内でバラバラ
15. 事実と解釈が混じっている
16. フィードバックがない
17. 変更が反映されてない
18. まとめ
19. Issue はプロダクト開発における コミュニケーションであり 道標でもある
20. 人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
21. 常に Issue を見て動く
22. おしまい