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.3k
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.8k
Hotwire を 本番環境で使ってみた感想
Avatar for zaru zaru_sakuraba
7
6.8k
失敗から学ぶ個人開発
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
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で実現する Compound Engineering
Avatar for Watanabe Takeshi(Buzz) tkc66buzz
1
310
synctest時代のhttptest Go 1.27で変わるHTTPサーバテストの裏側 / go conference2026 synctest and httptest
Avatar for Yoichiro Shimizu budougumi0617
1
2.6k
omasushiというライブラリを作った
Avatar for polidog polidog
PRO
0
190
AIで実装は速くなった。なのにプロダクトは速くならない。職能の壁を越えて価値のフローを設計する
Avatar for nwiizo nwiizo
8
7.8k
日経電子版を支えていく Kasane Design System/fec_fukuoka
Avatar for 日本経済新聞社 エンジニア採用事務局 nikkei_engineer_recruiting
0
660
WAF 運用改善の承認サイクル/SRE_BizReach_MIXI_1
Avatar for Visional Engineering ＆ Design visional_engineering_and_design
2
420
2026_devsumi_ozono.pdf
Avatar for O3(ozono) o3
2
330
こんなアーキテクチャ図は嫌だ BEYOND THE TIME: 半年後の自分へ贈る15のメッセージ / 15 of Anti-pattern in AWS Architecture Diagrams
Avatar for Naomi Yamasaki naospon
3
300
Screen Lens - 今見てる画面を翻訳する
Avatar for komagata komagata
0
240
Webとヘルスデータ
Avatar for Yuku Kotani yukukotani
1
370
KPIだけでは評価できないプロダクトが考えるべき Evalsという第二の評価系 / Beyond KPIs: Evals as a Second Evaluation Framework for Products #PdEConf
Avatar for Aki / @LoveIdahoBurger aki_iinuma
4
3.9k
コスト最適化の「めんどくさい」を AWS FinOps Agent でチョット楽にする
Avatar for kaz classmethod_kaz
0
300

Featured

See All Featured
Scaling GitHub
Avatar for Zach Holman holman
464
140k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
Avatar for Kevin Liebholz kevinliebholz
37
6.6k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
Avatar for Dan Newman danielanewman
230
23k
Winning Ecommerce Organic Search in an AI Era - #searchnstuff2025
Avatar for Aleyda Solis aleyda
1
2.1k
Navigating Weather and Climate Data
Avatar for Ryan Abernathey rabernat
0
510
The #1 spot is gone: here's how to win anyway
Avatar for Tamara Novitovic tamaranovitovic
3
1.2k
Exploring the relationship between traditional SERPs and Gen AI search
Avatar for Ray Grieselhuber raygrieselhuber
PRO
2
4.3k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
35
2.6k
How to build a perfect <img>
Avatar for Jono Alderson jonoalderson
1
6k
30 Presentation Tips
Avatar for Ian Lurie portentint
PRO
1
390
The AI Search Optimization Roadmap by Aleyda Solis
Avatar for Aleyda Solis aleyda
1
6.2k
The Curse of the Amulet
Avatar for Matthew Lei leimatthew05
2
14k

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