Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
伝わらない Issue の書き方
Search
zaru
April 18, 2019
Technology
0
780
伝わらない Issue の書き方
GitHub Issue などの書き方バッドプラクティス
zaru
April 18, 2019
Tweet
Share
More Decks by zaru
See All by zaru
Next.js App Router セキュリティ
zaru_sakuraba
13
4.6k
Hotwire を 本番環境で使ってみた感想
zaru_sakuraba
7
6.5k
失敗から学ぶ個人開発
zaru_sakuraba
18
5.4k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
zaru_sakuraba
0
160
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
zaru_sakuraba
4
570
もう「クレデンシャルください」なんて言わせない
zaru_sakuraba
5
1.5k
個人プロジェクト現状報告会
zaru_sakuraba
0
120
僕と契約して、メソッドになってよ!
zaru_sakuraba
0
170
Other Decks in Technology
See All in Technology
モバイルアプリ研修
recruitengineers
PRO
2
220
Go で言うところのアレは TypeScript で言うとコレ / Kyoto.なんか #7
susisu
5
1.5k
我々は雰囲気で仕事をしている / How can we do vibe coding as well
naospon
2
220
AIドリブンのソフトウェア開発 - うまいやり方とまずいやり方
okdt
PRO
9
580
第4回 関東Kaggler会 [Training LLMs with Limited VRAM]
tascj
12
1.7k
R-SCoRe: Revisiting Scene Coordinate Regression for Robust Large-Scale Visual Localization
takmin
0
430
キャリアを支え組織力を高める「多層型ふりかえり」 / 20250821 Kazuki Mori
shift_evolve
PRO
2
300
AIエージェントの開発に必須な「コンテキスト・エンジニアリング」とは何か──プロンプト・エンジニアリングとの違いを手がかりに考える
masayamoriofficial
0
370
認知戦の理解と、市民としての対抗策
hogehuga
0
320
会社にデータエンジニアがいることでできるようになること
10xinc
9
1.6k
あとはAIに任せて人間は自由に生きる
kentaro
3
1.1k
LLMエージェント時代に適応した開発フロー
hiragram
1
410
Featured
See All Featured
The Straight Up "How To Draw Better" Workshop
denniskardys
236
140k
RailsConf 2023
tenderlove
30
1.2k
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
194
16k
How to Ace a Technical Interview
jacobian
279
23k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
26k
Product Roadmaps are Hard
iamctodd
PRO
54
11k
Large-scale JavaScript Application Architecture
addyosmani
512
110k
Music & Morning Musume
bryan
46
6.7k
Fantastic passwords and where to find them - at NoRuKo
philnash
51
3.4k
Stop Working from a Prison Cell
hatefulcrawdad
271
21k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
15
1.6k
Put a Button on it: Removing Barriers to Going Fast.
kastner
60
4k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい