伝わるバグ報告 | さくらのナレッジ

この記事は2020年10月28日に行われたさくらの夕べ Tech Night #3 Onlineにおける発表を文章化したものです。 ダーシノと申します。さくらインターネットでフロントエンドエンジニアをやっています。この記事では、発生したバグをプログラマーに的確に伝えるためのバグ報告の書き方について説明しようと思います。 バグ報告にはコツがある！ プログラマをされている方で、過去にこんなバグ報告をもらった経験はないでしょうか。例えば「動きません」とだけ送られてきたりとか、イラッとした感情も含めた「使えねぇな！」みたいな報告、「アレもコレもソレもおかしいよ」みたいな、いろんなものが書かれた報告もあると思います。バグを残してリリースしてしまったプログラマーとしては非常に申し訳なくて今すぐ対応をしたいのですが、さすがに先ほどのようなバグ報告を受けても、我々プログラマは対応のしようがありません。「申

[shikiarai]

うちのお客さんは親切でここを押したらエラーになりましたってエラーになる前のキャプチャをくれる。発生後は頑なにくれない。

[bc_rikko]

エンジニアに優しいバグ報告の仕方を発表してきました。HARファイルだけでも覚えて帰ってください！

[tourism55]

気合入れてバグ報告書いて環境列挙してキャプチャもつけたら既知バグで「この設定にして暫定回避してね」って返事きた時の微妙な感じ…。

[riawiththesam]

仕様書も見ずに気に入らないからバグとして扱うやつ滅びてくれ

[rryu]

とりあえずURLとエラーメッセージさえあればなんとかなる感はあるが、そのエラーメッセージが「エラーが発生しました」だった時の絶望感たるや…

[nyop]

Skitch使ってみよう。

[hatest]

バグ報告という名の仕様変更というか、仕様がふにゃふにゃで試験者によって期待する動きが異なってて、バグ報告でデッドロック状態になったことがある

[t_motooka]

こういう文書を正しく作成できることこそが、仕事上でのコミュニケーション能力なんですよね。間違い無い。

[raimon49]

よい

[aox]

たいてい軽く叩くと直りますけどね

[yarumato]

“事実のみを伝える。不具合と、（仕様変更の）要望は、分ける。プログラマに崇め奉られるバグ報告：画面キャプチャー、エラーログ、HARファイル（Http ARchive。HTTPリクエストやレスポンスがヘッダもボディも全部含む”

[khtno73]

筆者名をタージンに空目して以降、脳内再生されて全然入ってこない

[respectbookmark]

お客さんにこのノウハウを伝えるか、が大事そう。

[t2hnd]

“ログをスクショでもコピーでもいいので”ログはテキストでお願いします…EXCELにスクショは嫌…

[primedesignworks]

仕様もしくは要件定義外の挙動、最悪な場合自分の要望を書いてるのに、ラベルを「バグ対応」としてくる客に何度も音読させたい。「パスワードを忘れるので表示しろ」は驚いた。バグってるのはお前の海馬だ。

[kitone]

実験レポートみたいなもんだと思うんです

[maemuki]

はてブアプリの通知がもう何週間も入ってこないです ブログの所で通知は来てるので、アプリがおかしいのかと。ログアウトをしても治らない。何とかしてください 伝わったかなあ

[ktmc]

ユーザが作り手のことを考える事なんて無いから、甘えてんなって感じ。ユーザの拙い報告から掴めないなら、要求を満たせてないもの作ってるだけでしょ。でも記載通り報告してくれたら五体投地するのはわかる。

[natu3kan]

事実と感想を分ける。要望と不具合を分ける。バグの発生条件がシビアなのだと動画の方が判りやすいのある。エラーメッセージで原因が判る系ならスクショで十分だけど。

[knok]

何度も話題になってはいまいち定着しない、いや新規参入者が知るきっかけを持たないのかな

[diabah_blue]

本当に必要な人にはたぶん届かない。そもそもこの文章を読み取れない。

[ya--mada]

人類はまだこんなことやっておるのか…。

[automatican]

デバッグ由来のバグで本番環境では大丈夫だったから取り下げ→実装後の本番環境で同じバグが発生ってことが何回かある

[akahigeg]

これ説明してもリテラシ低めのユーザーには厳しいことが多い。まあやってくれるようになる人もいるし愚直に説いていくしかないけど

[otihateten3510]

エンジニアが見ても意味ないんやで？

[yakisakeharami]

“HARはHttp ARchiveの略で、すべてのリクエストをJSON形式にまとめたファイル。Chromeの場合、デベロッパーツールの[Network]タブからリクエストがあるところで右クリックで[Save allas HAR with content]というメニューから生成。”

[hiboma]

"伝わるバグ報告" ができると解決に関われる人を増やせるので、技術者の「問題解決をスケールアウトする技術・スキル」みたいなもんだと思っている。

[mayumayu_nimolove]

32103210バグってハニー♪

[amnesia4646]

HAR、使おう。

[shag]

HARファイルなんてあるんだ。

[ene0kcal]

さくらにバグ報告したけど対応しなかった事は忘れてない（許さない）。詳細は書かないが仕様原因まで突き止めてやったのに。と、過去の不手際はこれからも恨み節を書く動機になっているのだよなぁ。（本文と無関係）

[Wafer]

バグ報告なんプログラマでも書くの下手な奴おるやんけ。あとどんなバグ報告でも大嫌いとか抜かしている奴、もしも本当にプログラマなら冗談でもそんなこと言うやつ向いてないからとっととやめちまいな

[halohalolin]

harファイルが気になる