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
760
伝わらない 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.4k
Hotwire を 本番環境で使ってみた感想
zaru_sakuraba
7
6.5k
失敗から学ぶ個人開発
zaru_sakuraba
18
5.4k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
zaru_sakuraba
0
150
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
zaru_sakuraba
4
560
もう「クレデンシャルください」なんて言わせない
zaru_sakuraba
5
1.5k
個人プロジェクト現状報告会
zaru_sakuraba
0
110
僕と契約して、メソッドになってよ!
zaru_sakuraba
0
170
Other Decks in Technology
See All in Technology
VS CodeとGitHub Copilotで爆速開発!アップデートの波に乗るおさらい会 / Rapid Development with VS Code and GitHub Copilot: Catch the Latest Wave
yamachu
2
400
ロールが細分化された組織でSREは何をするか?
tgidgd
1
260
オフィスビルを監視しよう:フィジカル×デジタルにまたがるSLI/SLO設計と運用の難しさ / Monitoring Office Buildings: The Challenge of Physical-Digital SLI/SLO Design & Operation
bitkey
1
370
AWS CDK 入門ガイド これだけは知っておきたいヒント集
anank
5
690
CDKコード品質UP!ナイスな自作コンストラクタを作るための便利インターフェース
harukasakihara
2
210
伴走から自律へ: 形式知へと導くSREイネーブリングによる プロダクトチームの信頼性オーナーシップ向上 / SRE NEXT 2025
visional_engineering_and_design
3
260
Figma Dev Mode MCP Serverを用いたUI開発
zoothezoo
0
130
データ基盤からデータベースまで?広がるユースケースのDatabricksについて教えるよ!
akuwano
3
170
Sansanのデータプロダクトマネジメントのアプローチ
sansantech
PRO
0
250
Introduction to Sansan for Engineers / エンジニア向け会社紹介
sansan33
PRO
5
39k
AWS CDKの仕組み / how-aws-cdk-works
gotok365
10
980
LLM拡張解体新書/llm-extension-deep-dive
oracle4engineer
PRO
8
1.1k
Featured
See All Featured
The Straight Up "How To Draw Better" Workshop
denniskardys
235
140k
Improving Core Web Vitals using Speculation Rules API
sergeychernyshev
18
980
It's Worth the Effort
3n
185
28k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
251
21k
YesSQL, Process and Tooling at Scale
rocio
173
14k
VelocityConf: Rendering Performance Case Studies
addyosmani
332
24k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
667
120k
KATA
mclloyd
30
14k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
21
1.3k
Writing Fast Ruby
sferik
628
62k
Six Lessons from altMBA
skipperchong
28
3.9k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
47
9.6k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい