Upgrade to Pro — share decks privately, control downloads, hide ads and more …

伝わらない Issue の書き方

Avatar for zaru zaru
April 18, 2019
Technology
1.1k
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
21
8.7k
Hotwire を 本番環境で使ってみた感想
Avatar for zaru zaru_sakuraba
7
6.8k
失敗から学ぶ個人開発
Avatar for zaru zaru_sakuraba
18
5.6k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
Avatar for zaru zaru_sakuraba
0
210
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
Avatar for zaru zaru_sakuraba
4
630
もう「クレデンシャルください」なんて言わせない
Avatar for zaru zaru_sakuraba
5
1.7k
個人プロジェクト現状報告会
Avatar for zaru zaru_sakuraba
0
160
僕と契約して、メソッドになってよ！
Avatar for zaru zaru_sakuraba
0
210

Other Decks in Technology

See All in Technology
DMM.com 購入改善推進チーム におけるCodeRabbitを用いた レビューフロー改善の一例
Avatar for Kanon ysknsid25
2
660
個人開発で育てる「大規模設計の苗床」 - AI時代の1人開発から始める業務への知識接続 / The Seedbed for Large-Scale Design - From AI-Era Solo Projects to Professional Knowledge
Avatar for 株式会社ビットキー / Bitkey Inc. bitkey
PRO
1
280
ガバナンスの「ちょうどいい落とし所」を探れ！開発スピードを妨げない運用判断の勘所 / SRE NEXT 2026
Avatar for GENDA genda
1
240
非定型なドキュメントを効率よくリファクタする 〜えぇ！？仕様書27本の移行が1日で終わったって！？〜
Avatar for subroh_0508 subroh0508
2
550
ヘルスケア領域における AI 活用と その安全性担保のための取り組み (Leveraging AI in Healthcare and Our Efforts to Ensure Its Safety) - Google I/O Extended Tokyo 2026, July 11, 2026
Avatar for Akira Tameoka zettaittenani
0
420
DatabricksにおけるMCPソリューション
Avatar for Takaaki Yayoi taka_aki
1
270
Gen3R: 3D Scene Generation Meets Feed-Forward Reconstruction
Avatar for Spatial AI Network spatial_ai_network
0
130
Type-safe IaC for Dart
Avatar for Nozomi Koborinai coborinai
0
160
カードゲーム作りが教えてくれた プロダクトオーナーシップ
Avatar for Sammy(MoritaMasami) moritamasami
0
110
企業でAWS Organizationsを動かすための組織設計の考え方
Avatar for NRI Netcom nrinetcom
PRO
1
110
ソニー銀行におけるビジネスアジリティ向上のためのクラウドシフト戦略
Avatar for srenext srenext
0
720
あなたの『Site』はどこですか？ — xREという考え方
Avatar for miyamu miyamu
0
1.2k

Featured

See All Featured
DevOps and Value Stream Thinking: Enabling flow, efficiency and business value
Avatar for Helen Beal helenjbeal
1
260
Paper Plane (Part 1)
Avatar for Katie Cordina Lindsey katiecoart
PRO
1
9.7k
Test your architecture with Archunit
Avatar for Yoan thirion
1
2.3k
Evolving SEO for Evolving Search Engines
Avatar for Ryan Jones ryanjones
0
240
Large-scale JavaScript Application Architecture
Avatar for Addy Osmani addyosmani
515
110k
Claude Code のすすめ
Avatar for schroneko schroneko
67
230k
Faster Mobile Websites
Avatar for Dean Hume deanohume
310
32k
Exploring the relationship between traditional SERPs and Gen AI search
Avatar for Ray Grieselhuber raygrieselhuber
PRO
2
4.1k
Why Mistakes Are the Best Teachers: Turning Failure into a Pathway for Growth
Avatar for Umar Saidu Auna auna
0
180
The Mindset for Success: Future Career Progression
Avatar for Greg Gifford greggifford
PRO
0
420
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
275
41k
Design of three-dimensional binary manipulators for pick-and-place task avoiding obstacles (IECON2024)
Avatar for konakalab konakalab
0
490

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