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
590
伝わらない Issue の書き方
GitHub Issue などの書き方バッドプラクティス
zaru
April 18, 2019
Tweet
Share
More Decks by zaru
See All by zaru
Hotwire を 本番環境で使ってみた感想
zaru_sakuraba
7
6k
失敗から学ぶ個人開発
zaru_sakuraba
18
5.3k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
zaru_sakuraba
0
110
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
zaru_sakuraba
4
470
もう「クレデンシャルください」なんて言わせない
zaru_sakuraba
5
1.3k
個人プロジェクト現状報告会
zaru_sakuraba
0
81
僕と契約して、メソッドになってよ!
zaru_sakuraba
0
130
Other Decks in Technology
See All in Technology
スレットハンティングについて知っておきたいこと
hacket
0
130
ギークの理想が7つ集まるエムスリーで夢を叶えよう - エムスリー株式会社
m3_engineering
1
260
【基調講演】変える、今ここから ― IoTとAIで紡ぐ未来
soracom
PRO
0
320
フルリモートワークはエンジニアの夢を叶えたか? #cm_odyssey
mamohacy
2
600
可視化プラットフォームGrafanaの基本と活用方法の全て
hamadakoji
0
230
JBUG岡山 #6 WordCamp男木島の チームビルディング
takeshifurusato
0
150
RAGのサービスをリリースして1年3ヶ月が経ちました
segavvy
4
910
テスト・設計研修【MIXI 24新卒技術研修】
mixi_engineers
PRO
0
170
公共領域から学ぶ クラウド移行についてエンジニアが意識していること
kawakawa2222
0
140
年間一億円削減した時系列データベースのアーキテクチャ改善~不確実性の高いプロジェクトへの挑戦~
lycorptech_jp
PRO
3
2.9k
データ分析基盤を作ってみよう~設計編~
nrinetcom
PRO
1
110
スタートアップにおける組織設計とスクラムの長期戦略 / Scrum Fest Kanazawa 2024
yoshikiiida
13
3.6k
Featured
See All Featured
Clear Off the Table
cherdarchuk
89
320k
The Cost Of JavaScript in 2023
addyosmani
31
4.7k
ParisWeb 2013: Learning to Love: Crash Course in Emotional UX Design
dotmariusz
105
6.8k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
26
2.1k
Robots, Beer and Maslow
schacon
PRO
157
8.1k
5 minutes of I Can Smell Your CMS
philhawksworth
200
19k
Ruby is Unlike a Banana
tanoku
96
10k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
121
18k
Debugging Ruby Performance
tmm1
71
11k
Producing Creativity
orderedlist
PRO
340
39k
How to Think Like a Performance Engineer
csswizardry
4
590
For a Future-Friendly Web
brad_frost
173
9.2k
Transcript
伝わらない Issue の書き方 @zaru
Issue イズ 何?
Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード(ToDo リスト)ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの=議論する
• プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切
伝わらない Issue の書き方とは
「ここ直しておいてください」と 口頭で お願いする
タイトルだけの Issue
背景が書かれていない
希望スケジュール が曖昧
なぜか偉そうな物言い
URLや再現方法 の 記載がない不具合報告
見た目に依存するのに スクリーンショットがなく 言葉で説明されている
複数の Issue が一つになってる
仮説と計測条件のない施策
用語がチーム内でバラバラ
事実と解釈が混じっている
フィードバックがない
変更が反映されてない
まとめ
Issue はプロダクト開発における コミュニケーションであり 道標でもある
人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物
常に Issue を見て動く
おしまい