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

伝わらない Issue の書き方

Avatar for zaru zaru
April 18, 2019
Technology
0
760

伝わらない Issue の書き方

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

zaru

April 18, 2019
Tweet

More Decks by zaru

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

Other Decks in Technology

See All in Technology
データ基盤からデータベースまで？広がるユースケースのDatabricksについて教えるよ！
Avatar for Akihiro Kuwano akuwano
3
130
事業成長の裏側：エンジニア組織と開発生産性の進化 / 20250703 Rinto Ikenoue
Avatar for SHIFT EVOLVE shift_evolve
PRO
3
22k
OSSのSNSツール「Misskey」をさわってみよう（右下ワイプで私のOSCの20年を振り返ります） / 20250705-osc2025-do
Avatar for Akira Ouchi akkiesoft
0
170
CDK Vibe Coding Fes
Avatar for tomoki10 tomoki10
0
150
60以上のプロダクトを持つ組織における開発者体験向上への取り組み - チームAPIとBackstageで構築する組織の可視化基盤 - / sre next 2025 Efforts to Improve Developer Experience in an Organization with Over 60 Products
Avatar for VTRyo vtryo
2
410
対話型音声AIアプリケーションの信頼性向上の取り組み
Avatar for 株式会社IVRy（社員登壇資料） ivry_presentationmaterials
1
290
無意味な開発生産性の議論から抜け出すための予兆検知とお金とAI
Avatar for Masato Ishigaki / 石垣雅人 i35_267
6
13k
Lufthansa ®️ USA Contact Numbers: Complete 2025 Support Guide
Avatar for danielconkling870 lufthanahelpsupport
0
220
ABEMAの本番環境負荷試験への挑戦
Avatar for Miyazaki Taiga mk2taiga
3
200
FOSS4G 2025 KANSAI　QGISで点群データをいろいろしてみた
Avatar for kou_kita kou_kita
0
410
開発生産性を測る前にやるべきこと - 組織改善の実践 / Before Measuring Dev Productivity
Avatar for 株式会社カオナビ kaonavi
13
6.1k
事例で学ぶ！B2B SaaSにおけるSREの実践例/SRE for B2B SaaS: A Real-World Case Study
Avatar for 株式会社ビットキー / Bitkey Inc. bitkey
0
110

Featured

See All Featured
Practical Orchestrator
Avatar for Shlomi Noach shlominoach
189
11k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
Avatar for Stéphanie Walter stephaniewalter
281
13k
How GitHub (no longer) Works
Avatar for Zach Holman holman
314
140k
The Pragmatic Product Professional
Avatar for Laura Van Doore lauravandoore
35
6.7k
Side Projects
Avatar for Sacha Greif sachag
455
42k
For a Future-Friendly Web
Avatar for Brad Frost brad_frost
179
9.8k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
Avatar for Joe Casabona jcasabona
32
2.4k
Speed Design
Avatar for Sergey Chernyshev sergeychernyshev
32
1k
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
273
40k
Adopting Sorbet at Scale
Avatar for Ufuk Kayserilioglu ufuk
77
9.5k
Visualization
Avatar for Eitan Lees eitanlees
146
16k
Helping Users Find Their Own Way: Creating Modern Search Experiences
Avatar for Dan Newman danielanewman
29
2.7k

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