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
テスト設計の本質を改めて考えてみる～生成AIを活用する時代だからこそ、作ったテストの説明性を高めよう～
Avatar for YAMASAKI Takashi yamasaki696
1
390
GuardrailからGovernanceへ～AIエージェント運用の次の課題～
Avatar for 吉岡駿 sbspsy
1
220
SRE Lounge Hiroshimaへの招待
Avatar for gr1m0h grimoh
0
410
Terraform共通モジュールをチーム横断で“変えられる”運用へ ― リリースと適用の分離
Avatar for kekke-n kekke_n
0
1.8k
AI時代のエンジニアキャリアについて今一度考える
Avatar for Sakamoto sakamoto_582
2
1.3k
プロダクトだけじゃない、社内プロセスにおける自動化・省力化ノススメ
Avatar for KAKEHASHI kakehashi
PRO
1
2.8k
NDIAS CTF 2026 問題解説会資料
Avatar for bata_24 bata_24
0
180
勉強会企画をアプリで構造化してみた 〜そこで見えた、AIとの付き合い方〜 / I've structured a study group plan using an app.
Avatar for Pauli pauli
0
330
Claude Code 珍プレー好プレー
Avatar for Shinya Saita shinyasaita
0
290
知らん間に、回ってる
Avatar for ming ming_ayami
0
330
クラウド上のデータ復旧で見落としがちな制約: 医療系 SaaS の BCP 設計から得た教訓
Avatar for KAKEHASHI kakehashi
PRO
0
2.5k
デジタル・デザイン：次の50年を描く「進化する青写真」
Avatar for Sayaka Ishizuka y150saya
0
840

Featured

See All Featured
Why Your Marketing Sucks and What You Can Do About It - Sophie Logan
Avatar for Sophie Logan marketingsoph
0
190
Balancing Empowerment & Direction
Avatar for Lara Hogan lara
6
1.2k
Un-Boring Meetings
Avatar for Sebastian Deterding codingconduct
0
330
Gemini Prompt Engineering: Practical Techniques for Tangible AI Outcomes
Avatar for Mfonobong Umondia mfonobong
2
460
The Invisible Side of Design
Avatar for Vitaly Friedman smashingmag
301
52k
Fashionably flexible responsive web design (full day workshop)
Avatar for Andy Clarke malarkey
408
66k
The Curse of the Amulet
Avatar for Matthew Lei leimatthew05
2
13k
We Analyzed 250 Million AI Search Results: Here's What I Found
Avatar for Josh Blyskal joshbly
1
1.5k
Typedesign – Prime Four
Avatar for Hannes Fritz hannesfritz
42
3.1k
Joys of Absence: A Defence of Solitary Play
Avatar for Sebastian Deterding codingconduct
1
410
16th Malabo Montpellier Forum Presentation
Avatar for AKADEMIYA2063 akademiya2063
PRO
0
170
Digital Projects Gone Horribly Wrong (And the UX Pros Who Still Save the Day) - Dean Schuster
Avatar for UX Y'all uxyall
1
1.9k

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