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
550
伝わらない Issue の書き方
GitHub Issue などの書き方バッドプラクティス
zaru
April 18, 2019
Tweet
Share
More Decks by zaru
See All by zaru
Hotwire を 本番環境で使ってみた感想
zaru_sakuraba
7
5.7k
失敗から学ぶ個人開発
zaru_sakuraba
18
5.2k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
zaru_sakuraba
0
100
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
zaru_sakuraba
4
460
もう「クレデンシャルください」なんて言わせない
zaru_sakuraba
5
1.2k
個人プロジェクト現状報告会
zaru_sakuraba
0
75
僕と契約して、メソッドになってよ!
zaru_sakuraba
0
120
Other Decks in Technology
See All in Technology
DevOpsメトリクスとアウトカムの接続にトライ!開発プロセスを通して計測できるメトリクスの活用方法
ham0215
0
170
Databricks におけるデータエンジニアリング
databricksjapan
0
370
SPI原点回帰論:事業課題とFour Keysの結節点を見出す実践的ソフトウェアプロセス改善 / DevOpsDays Tokyo 2024
visional_engineering_and_design
4
1.3k
Tebiki株式会社 エンジニア採用資料
tebiki
0
4k
PHP"オレ"カンファレンスの告知
ysknsid25
0
310
マルチアカウント環境への発見的統制の導入
ch1aki
1
1.3k
ここが嬉しいABAC ここが辛いよABAC #再解説+補足編
masahirokawahara
0
170
コードを書く隙間を見つけて生きていく技術/Findy 思考の現在地
fujiwara3
24
4.8k
Tableau事例紹介 / Tableau Case Study of Eureka
kazuya_araki_tokyo
1
170
Oracle Exadata Database Service on Cloud@Customer (ExaDB-C@C) - UI スクリーン・キャプチャ集
oracle4engineer
PRO
1
1.1k
Microsoft Cloudで開発ライフサイクルを保護する
kkamegawa
0
140
シン・Kafka / shin-kafka
oracle4engineer
PRO
6
2.7k
Featured
See All Featured
5 minutes of I Can Smell Your CMS
philhawksworth
199
19k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
240
1.2M
GraphQLの誤解/rethinking-graphql
sonatard
49
9.2k
Faster Mobile Websites
deanohume
296
30k
Bootstrapping a Software Product
garrettdimon
PRO
301
110k
Build The Right Thing And Hit Your Dates
maggiecrowley
23
2k
How GitHub Uses GitHub to Build GitHub
holman
468
290k
Building an army of robots
kneath
300
41k
Producing Creativity
orderedlist
PRO
336
39k
Side Projects
sachag
451
41k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
352
28k
A Modern Web Designer's Workflow
chriscoyier
689
190k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい