伝わらない Issue の書き方

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

Transcript

1. 伝わらない Issue の書き方
   @zaru
   

   View Slide

2. Issue イズ 何？
   

   View Slide

3. Issue とはプロダクトの未来を議論し決めるもの
   ● 単なるタスクボード（ToDo リスト）ではない
   ● エンジニアやデザイナーとのコミュニケーションツール
   ● Issue は、みんなで育てるもの＝議論する
   ● プロダクトが目指している世界観を実現するための道標
   ● 実利的な面でみると思考と行動の足跡とも言える
   つまり…めっちゃ大切
   

   View Slide

4. 伝わらない Issue の書き方とは
   

   View Slide

5. 「ここ直しておいてください」と
   口頭で　お願いする
   

   View Slide

6. タイトルだけの Issue
   

   View Slide

7. 背景が書かれていない
   

   View Slide

8. 希望スケジュール　が曖昧
   

   View Slide

9. なぜか偉そうな物言い
   

   View Slide

10. URLや再現方法　の
    記載がない不具合報告
    

    View Slide

11. 見た目に依存するのに
    スクリーンショットがなく
    言葉で説明されている
    

    View Slide

12. 複数の Issue が一つになってる
    

    View Slide

13. 仮説と計測条件のない施策
    

    View Slide

14. 用語がチーム内でバラバラ
    

    View Slide

15. 事実と解釈が混じっている
    

    View Slide

16. フィードバックがない
    

    View Slide

17. 変更が反映されてない
    

    View Slide

18. まとめ
    

    View Slide

19. Issue はプロダクト開発における
    コミュニケーションであり
    道標でもある
    

    View Slide

20. 人はすぐに忘れるし
    齟齬が発生するし
    道に迷う生き物
    

    View Slide

21. 常に Issue を見て動く
    

    View Slide

22. おしまい
    

    View Slide