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
730
伝わらない 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.1k
Hotwire を 本番環境で使ってみた感想
zaru_sakuraba
7
6.5k
失敗から学ぶ個人開発
zaru_sakuraba
18
5.4k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
zaru_sakuraba
0
150
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
zaru_sakuraba
4
550
もう「クレデンシャルください」なんて言わせない
zaru_sakuraba
5
1.4k
個人プロジェクト現状報告会
zaru_sakuraba
0
110
僕と契約して、メソッドになってよ!
zaru_sakuraba
0
160
Other Decks in Technology
See All in Technology
AI Development in .NET - Microsoft.Extensions.AI
_mertmetin
0
100
経済メディア編集部の実務に小さく刺さるAI / small-ai-with-editorial
nkzn
2
530
GPU 클라우드 환경에서의 회복탄력적 AI 운영 : 훈련 및 추론을 위한 견고한 아키텍처와 전략
inureyes
PRO
0
140
Amplifyとゼロからはじめた AIコーディング。失敗と気づき
mkdev10
1
190
AWS LambdaをTypeScriptで動かして分かった、Node.jsのTypeScriptサポートの利点と課題
smt7174
1
370
20250514 1Passwordを使い倒す道場 vol.1
east_takumi
0
160
SaaS公式MCPサーバーをリリースして得た学び
kawamataryo
5
1.4k
さくらのクラウド 開発の挑戦とその舞台裏
kazeburo
0
230
The PyArrow revolution in Pandas
reuven
0
130
Next.jsと状態管理のプラクティス
uhyo
6
2.4k
VitePress & MCPでアプリ仕様のオープン化に挑戦する
hal_spidernight
0
150
OCI Full Stack Disaster Recovery サービス概要
oracle4engineer
PRO
1
140
Featured
See All Featured
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
30
2.4k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
367
26k
The Pragmatic Product Professional
lauravandoore
33
6.6k
Faster Mobile Websites
deanohume
307
31k
A Tale of Four Properties
chriscoyier
159
23k
Rails Girls Zürich Keynote
gr2m
94
13k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
Building a Modern Day E-commerce SEO Strategy
aleyda
40
7.3k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
52
2.7k
Fantastic passwords and where to find them - at NoRuKo
philnash
51
3.2k
Raft: Consensus for Rubyists
vanstee
137
6.9k
Build your cross-platform service in a week with App Engine
jlugia
231
18k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい