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
Rethinking Incident Response: Context-Aware AI in Practice
rrreeeyyy
1
230
スタートアップに選択肢を 〜生成AIを活用したセカンダリー事業への挑戦〜
nstock
0
270
AI エージェントと考え直すデータ基盤
na0
17
6.8k
AWS CDK 開発を成功に導くトラブルシューティングガイド
wandora58
3
140
cdk initで生成されるあのファイル達は何なのか/cdk-init-generated-files
tomoki10
1
430
CDK Vibe Coding Fes
tomoki10
1
450
Delta airlines Customer®️ USA Contact Numbers: Complete 2025 Support Guide
deltahelp
0
1.1k
事例で学ぶ!B2B SaaSにおけるSREの実践例/SRE for B2B SaaS: A Real-World Case Study
bitkey
1
270
Contributing to Rails? Start with the Gems You Already Use
yahonda
2
120
「Chatwork」のEKS環境を支えるhelmfileを使用したマニフェスト管理術
hanayo04
1
210
ポストコロナ時代の SaaS におけるコスト削減の意義
izzii
1
190
伴走から自律へ: 形式知へと導くSREイネーブリングによる プロダクトチームの信頼性オーナーシップ向上 / SRE NEXT 2025
visional_engineering_and_design
2
180
Featured
See All Featured
A Tale of Four Properties
chriscoyier
160
23k
Building a Scalable Design System with Sketch
lauravandoore
462
33k
Java REST API Framework Comparison - PWX 2021
mraible
31
8.7k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
35
2.4k
What's in a price? How to price your products and services
michaelherold
246
12k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
50
5.5k
Fireside Chat
paigeccino
37
3.5k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
8
830
4 Signs Your Business is Dying
shpigford
184
22k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
45
7.5k
Building Adaptive Systems
keathley
43
2.7k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい