Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

伝わらない Issue の書き方

Sponsored · Ship Features Fearlessly Turn features on and off without deploys. Used by thousands of Ruby developers. →
Avatar for zaru zaru
April 18, 2019
Technology
1.4k
1

伝わらない Issue の書き方

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

Avatar for zaru

zaru

April 18, 2019

More Decks by zaru

See All by zaru
Next.js App Router セキュリティ
Avatar for zaru zaru_sakuraba
22
8.9k
Hotwire を 本番環境で使ってみた感想
Avatar for zaru zaru_sakuraba
7
6.9k
失敗から学ぶ個人開発
Avatar for zaru zaru_sakuraba
18
5.6k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
Avatar for zaru zaru_sakuraba
0
220
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
Avatar for zaru zaru_sakuraba
4
650
もう「クレデンシャルください」なんて言わせない
Avatar for zaru zaru_sakuraba
5
1.7k
個人プロジェクト現状報告会
Avatar for zaru zaru_sakuraba
0
170
僕と契約して、メソッドになってよ！
Avatar for zaru zaru_sakuraba
0
230

Other Decks in Technology

See All in Technology
DGX Spark でどこまでハッキングができるのか？
Avatar for kash1064 kash1064
3
1.4k
アカウント統制の健康診断
Avatar for KenichiNakamura kenichinakamura
1
110
僕のハーネスを紹介します
Avatar for watany watany
5
1.4k
Active Record Connection Adaptersにおける長年の課題に再び取り組む
Avatar for Yasuo Honda yahonda
0
410
野蛮なアジャイル ［サイボウズ発！］組織の常識を覆した反骨のスクラム実践記 / Barbaric Agile - Enterprise Agile Study Group
Avatar for ama-ch ama_ch
0
120
freeeにおけるSoftware Factory
Avatar for freee freee
PRO
0
270
AIネイティブ企業への変革。パーソルキャリアが挑む「データメッシュ×ガバナンス」のアーキテクチャ戦略
Avatar for PERSOL CAREER Dev | techtekt techtekt
PRO
0
120
「私が一番顧客に詳しい」を捨てる～ 全員が一次情報に精通する開発チームをつくり、PMが次のボトルネックへ染み出すまで
Avatar for 株式会社カミナシ kaminashi
3
1.2k
Refining Active Record
Avatar for Shugo Maeda shugo
0
190
DevelopersIO 2026 Tokyo 現時点の衛星通信サービスの現状を整理してみる
Avatar for maroon1st maroon1st
0
140
ストレスなくAIと付き合いたい！こんなときどうしてる？
Avatar for Nami Kimura namiki64
4
660
freeeにおける AI を用いた ブラウザ動作確認の自動化の取り組み
Avatar for freee freee
PRO
0
120

Featured

See All Featured
How to Think Like a Performance Engineer
Avatar for Harry Roberts csswizardry
28
2.9k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
Avatar for panda_program panda_program
123
22k
From π to Pie charts
Avatar for Rasagy Sharma rasagy
1
400
Building a Scalable Design System with Sketch
Avatar for Laura Van Doore lauravandoore
464
34k
The Curious Case for Waylosing
Avatar for Cassini Nazir cassininazir
1
570
We Have a Design System, Now What?
Avatar for Morgane Peng morganepeng
55
8.4k
30 Presentation Tips
Avatar for Ian Lurie portentint
PRO
1
430
The #1 spot is gone: here's how to win anyway
Avatar for Tamara Novitovic tamaranovitovic
4
1.2k
[SF Ruby Conf 2025] Rails X
Avatar for Vladimir Dementyev palkan
3
1.5k
How to Build an AI Search Optimization Roadmap - Criteria and Steps to Take #SEOIRL
Avatar for Aleyda Solis aleyda
1
2.2k
Build your cross-platform service in a week with App Engine
Avatar for Jose L jlugia
234
19k
Into the Great Unknown - MozCon
Avatar for Noah Learner thekraken
41
2.8k

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