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

伝わらない Issue の書き方

Sponsored · SiteGround - Reliable hosting with speed, security, and support you can count on. →
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 Etsuji Nakai enakai00
7
4.6k
Android skills に学ぶ
Avatar for kokiko kokiko
0
160
型落ちシンクライアント端末のPoEモジュールを自作したかった話
Avatar for Takuto Nagami logica0419
0
380
RapidCopy2 Matrix I/Oエンジンによるファイルコピーソフトウェアの設計と実装
Avatar for Kengo Sawatsu kengosawa2
1
350
LLM Internals: 언어 모델의 계보와 알고리즘 진화 (2023~2026)
Avatar for Jeongkyu Shin inureyes
PRO
1
890
暗号化？某ファイルストレージはどうなるの！？ 3rd Partyとうまく付き合う秘密度ラベル設計
Avatar for Kaz Asada | しがない情シス kasada
0
160
安全性・開発速度・ユーザー体験の あいだで考える 事業会社のプロダクトセキュリティ
Avatar for MIXI ENGINEERS mixi_engineers
PRO
0
100
私がブラウザを自作したくなった理由
Avatar for Miyamoto Naoyuki supurazako
1
280
国家プロジェクトを支える「さくらONE」 大規模LLM開発におけるGPU障害を乗り越えるクラスター運用戦略
Avatar for GPU UNITE gpuunite_official
0
260
平文パスワードはログに“残り” ── 肝心の侵入は“痕跡すら残らない”
Avatar for kuroneko kuroneko13
0
120
[potatotips #96] Give Your AI Agent the Flutter Playbook
Avatar for Kenichi Kambara korodroid
0
150
属人化を叩き割れ！「制作加速」と「安定化」の矛盾を打破する：8年目プロダクトが辿り着いた「ミスが起こり得ない」アセット制作フローの全貌
Avatar for gree_tech gree_tech
PRO
0
360

Featured

See All Featured
Designing Experiences People Love
Avatar for Jonathan Moore moore
143
24k
The Art of Programming - Codeland 2020
Avatar for Erika Heidi erikaheidi
57
14k
Lightning Talk: Beautiful Slides for Beginners
Avatar for Ines Montani inesmontani
PRO
2
640
Mobile First: as difficult as doing things right
Avatar for Swwweet swwweet
225
10k
<Decoding/> the Language of Devs - We Love SEO 2024
Avatar for Nikki Halliwell nikkihalliwell
1
300
The State of eCommerce SEO: How to Win in Today's Products SERPs - #SEOweek
Avatar for Aleyda Solis aleyda
2
11k
AI in Enterprises - Java and Open Source to the Rescue
Avatar for ivargrimstad ivargrimstad
0
1.4k
Typedesign – Prime Four
Avatar for Hannes Fritz hannesfritz
42
3.1k
The Cost Of JavaScript in 2023
Avatar for Addy Osmani addyosmani
55
10k
The Straight Up "How To Draw Better" Workshop
Avatar for Dennis Kardys denniskardys
239
140k
jQuery: Nuts, Bolts and Bling
Avatar for Doug Neiner dougneiner
66
8.6k
Site-Speed That Sticks
Avatar for Harry Roberts csswizardry
13
1.5k

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