Upgrade to Pro — share decks privately, control downloads, hide ads and more …

伝わらない Issue の書き方

1e68801494505bd0e0ce67e2e1398af3?s=47 zaru
April 18, 2019
Technology
0
270

伝わらない Issue の書き方

GitHub Issue などの書き方バッドプラクティス

1e68801494505bd0e0ce67e2e1398af3?s=128

zaru

April 18, 2019
Tweet

More Decks by zaru

See All by zaru
Hotwire を 本番環境で使ってみた感想
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
7
4.5k
失敗から学ぶ個人開発
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
18
4.9k
とあるプロジェクトでコードを書き始めた僕がつまづいた石たち
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
0
72
Ruby との対話 : pry を使い pry をデバッグし pry のバグを直す話
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
3
330
もう「クレデンシャルください」なんて言わせない
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
4
900
個人プロジェクト現状報告会
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
0
51
僕と契約して、メソッドになってよ！
1e68801494505bd0e0ce67e2e1398af3?s=48 zaru_sakuraba
0
86

Other Decks in Technology

See All in Technology
Puny to Powerful PostgreSQL Rails Apps
65e84915478a95a22dd40da712f304df?s=48 andyatkinson
PRO
0
280
プルリク作ったらデプロイされる仕組み on ECS / SRE NEXT 2022
2537ce662eb08182e617ec7944981437?s=48 carta_engineering
1
220
実験！カオスエンジニアリング / How to Chaos Engineering
140494d272a4d89883a94fdfdb29dea2?s=48 oracle4engineer
PRO
0
140
アルプの 認証/認可分離戦略と手法
C6a8cb5e13aa716521d522471ec4e4cd?s=48 ma2k8
PRO
1
300
Whats new in Android Media?
35e891f6b7c223caa0e69b665f23b115?s=48 myolwin00
2
100
街じゅうを"駅前化"する電動マイクロモビリティのシェアサービス「LUUP」のIoTとSRE
1333e8256b0ba80c369f4bcc98a839d7?s=48 0gm
1
660
Unity Package Managerで自作パッケージを配布する方法
3dfed36dc1543f0007b5fd46fcb41a47?s=48 yunoda
0
170
Building smarter apps with machine learning, from magic to reality
7e6a435700dda6cdb22105d601f20892?s=48 picardparis
4
3.1k
1,000万人以上が利用する「家族アルバム みてね」のSRE組織は4年間でどのように作られてきたのか/SRE NEXT 2022
46839cf590a549efe13547c17a6b2fde?s=48 isaoshimizu
4
2.9k
Spotify物理コントローラーがほしい
1dceaa2dcea41c16004f430c1723b20e?s=48 miso
0
160
New Features in C# 10/11
1c3658db58f755e44fc1a70255c08ff7?s=48 chack411
0
930
jaws-ug-asa-datasync-20220510
3cb071df50ed06febdfb3262fb5a67a3?s=48 hiashisan
0
480

Featured

See All Featured
Imperfection Machines: The Place of Print at Facebook
7c8469ee8c9e594c65c59b919626c08d?s=48 scottboms
253
11k
Mobile First: as difficult as doing things right
0fe2973fa8d27d96547e43322341183a?s=48 swwweet
212
7.5k
A Tale of Four Properties
8081b26e05bb4354f7d65ffc34cbbd67?s=48 chriscoyier
149
20k
Become a Pro
828ace851b606e1206900f26459f55ad?s=48 speakerdeck
PRO
3
780
VelocityConf: Rendering Performance Case Studies
96270e4c3e5e9806cf7245475c00b275?s=48 addyosmani
316
22k
Embracing the Ebb and Flow
C9b18d9dff88a9dd2393364c2b3b21bd?s=48 colly
73
3.3k
Practical Orchestrator
168ccec72eee0530b818d44f3fedaacf?s=48 shlominoach
178
8.6k
StorybookのUI Testing Handbookを読んだ
50fc0fdc2327ecbe7350645812de52e3?s=48 zakiyama
4
2k
Designing Dashboards & Data Visualisations in Web Apps
Fde6c3a50ca518a909ef35c22c0ee0e4?s=48 destraynor
224
49k
Unsuck your backbone
B83d5b590577969ee79a5ad845411a7d?s=48 ammeep
659
55k
Fantastic passwords and where to find them - at NoRuKo
8ec1383b240b5ba15ffb9743fceb3c0e?s=48 philnash
25
1.5k
Scaling GitHub
78b475797a14c84799063c7cd073962f?s=48 holman
451
140k

Transcript

  1. 伝わらない Issue の書き方 @zaru

  2. Issue イズ 何？

  3. Issue とはプロダクトの未来を議論し決めるもの • 単なるタスクボード（ToDo リスト）ではない • エンジニアやデザイナーとのコミュニケーションツール • Issue は、みんなで育てるもの＝議論する

    • プロダクトが目指している世界観を実現するための道標 • 実利的な面でみると思考と行動の足跡とも言える つまり…めっちゃ大切

  4. 伝わらない Issue の書き方とは

  5. 「ここ直しておいてください」と 口頭で　お願いする

  6. タイトルだけの Issue

  7. 背景が書かれていない

  8. 希望スケジュール　が曖昧

  9. なぜか偉そうな物言い

  10. URLや再現方法　の 記載がない不具合報告

  11. 見た目に依存するのに スクリーンショットがなく 言葉で説明されている

  12. 複数の Issue が一つになってる

  13. 仮説と計測条件のない施策

  14. 用語がチーム内でバラバラ

  15. 事実と解釈が混じっている

  16. フィードバックがない

  17. 変更が反映されてない

  18. まとめ

  19. Issue はプロダクト開発における コミュニケーションであり 道標でもある

  20. 人はすぐに忘れるし 齟齬が発生するし 道に迷う生き物

  21. 常に Issue を見て動く

  22. おしまい