伝わらない Issue の書き方

1e68801494505bd0e0ce67e2e1398af3?s=47 zaru
April 18, 2019

伝わらない Issue の書き方

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

1e68801494505bd0e0ce67e2e1398af3?s=128

zaru

April 18, 2019
Tweet

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. おしまい