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

伝わらない Issue の書き方

Avatar for zaru zaru
April 18, 2019
Technology
1.2k
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
640
もう「クレデンシャルください」なんて言わせない
Avatar for zaru zaru_sakuraba
5
1.7k
個人プロジェクト現状報告会
Avatar for zaru zaru_sakuraba
0
160
僕と契約して、メソッドになってよ！
Avatar for zaru zaru_sakuraba
0
220

Other Decks in Technology

See All in Technology
AIで変わるエンジニアの働き方（仮）
Avatar for naoinaoi naoinaoi
0
190
JavaScript 研修 (2026)
Avatar for Recruit recruitengineers
PRO
2
660
AI時代に、人は何を、どう学ぶのか #pbl_pub / What and How Do We Learn in the AI Era?
Avatar for TAKAKING22 takaking22
1
150
Eight Engineering Unit 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
3
8.2k
Apache Icebergインフラストラクチャ: ストレージ・カタログ・エンジンの選択肢と Clouderaプラットフォームでの実装
Avatar for tsugiyama-cloudera tsugiyama
0
120
【GCC2026】TrueHDRIを用いたルックデブ環境とライティングテクニック
Avatar for Bandai Namco Studios Inc. bandainamcostudios
PRO
0
120
2026-08-15 JAWS-UG 茨城 #16 Secrets ManagerにおけるSecret値の管理(Terraformの場合) / Secrets Manager Secrets
Avatar for SUZUKI Masashi masasuzu
0
360
Flutter × BLE Centralを自前Pluginで実装する設計パターン - MethodChannel / EventChannelで作る双方向ブリッジの実践 / Building Custom Flutter BLE Central Plugins: Bidirectional Bridging with Method & Event Channels
Avatar for 株式会社ビットキー / Bitkey Inc. bitkey
PRO
0
170
AIに持続⼒を与える 判断の⻑期記憶設計
Avatar for eiei114 eiei114
1
350
Agent 時代の Kaggle 展望 / kaggle-in-the-agentic-era
Avatar for Shotaro Ishihara upura
1
850
AI開発に用いられるHPC技術について
Avatar for GPU UNITE gpuunite_official
0
150
モノリス Rails でも日中に rails db:migrate を走らせたい！ / Daytime rails db:migrate on Monolithic Rails!
Avatar for Shintani Teppei euglena1215
4
650

Featured

See All Featured
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
Avatar for Michelle Schulp Hunt marktimemedia
31
2.9k
Future Trends and Review - Lecture 12 - Web Technologies (1019888BNR)
Avatar for Beat Signer signer
PRO
0
3.7k
Paper Plane
Avatar for Katie Cordina Lindsey katiecoart
PRO
2
53k
The Language of Interfaces
Avatar for Des Traynor destraynor
162
27k
Designing for Performance
Avatar for Lara Hogan lara
611
70k
Color Theory Basics | Prateek | Gurzu
Avatar for Gurzu gurzu
0
430
WCS-LA-2024
Avatar for Leonardo Collado-Torres lcolladotor
0
800
Fashionably flexible responsive web design (full day workshop)
Avatar for Andy Clarke malarkey
408
67k
Crafting Experiences
Avatar for Bethany Jepchumba bethany
1
260
SEO in 2025: How to Prepare for the Future of Search
Avatar for Michael King ipullrank
3
3.8k
The Mindset for Success: Future Career Progression
Avatar for Greg Gifford greggifford
PRO
0
460
Joys of Absence: A Defence of Solitary Play
Avatar for Sebastian Deterding codingconduct
1
440

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