トラブルシュート

固定ヘッダーでスクロール位置がずれるときに相手へ伝える確認依頼の書き方

共有したHTMLの「目次をクリックしても見出しが隠れる」バグを相手に発見・報告してもらうとき、どう確認依頼を書けばよいか悩む場面があります。必要な情報を最初の1通に詰め込むことで、往復を減らして素早く解決できます。

よくある原因

確認依頼がうまく機能しない主な理由は「どこを、どう操作して、何を見ればよいか」が曖昧なためです。「スクロールして確認してください」だけでは、相手が目次リンクをクリックする操作をしないかもしれませんし、ずれていても気づかないことがあります。

また、相手が普段スクロールのずれを意識していない場合、少しずれていても「見えているから問題ない」と判断して問題なしと返信するケースがあります。「見出しがヘッダーの裏に隠れていないか」という具体的な確認ポイントを示すと、正確なフィードバックが得られます。

  • 相手がログインなしで開ける状態か確認する
  • PCとスマホで最低1回ずつ表示を確認する
  • 内部情報・個人情報・不要な外部送信が残っていないか見る
  • レビュー期限と修正時の差し替え方を決めておく

自分側で確認すること

依頼を送る前に、自分でも共有URLの目次リンクをすべてクリックして確認しておきます。自分でバグを確認済みなら「以下の問題が発生していることを確認しています。相手のデバイスでも同様か教えてください」と状況を共有でき、相手が何を探せばよいかが明確になります。

自分では問題が出ていないが相手から報告があった場合、依頼文に「私の環境では問題なく見えていますが」と前置きした上で確認を依頼すると、相手が環境差異として捉えやすくなります。一方的に「バグがあります」と断定すると混乱を招くことがあるため、双方の環境を前提にした表現にしましょう。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

相手側で確認すること

相手へ送る確認依頼文の必須要素は次の3点です:①操作手順(「ページ上部の目次から各項目をクリック」)②確認ポイント(「クリック後に見出しがヘッダーに隠れていないか」)③報告方法(「問題があればその見出しのスクリーンショットを添付」)。この3点が揃っていれば相手の返信精度が大きく上がります。

相手がスマートフォンで確認する場合、モバイル版では目次がハンバーガーメニュー内に格納されていることがあり、操作方法がデスクトップと異なります。「スマートフォンで見る場合はメニューアイコンを開いてから」という補足を依頼文に入れておくと、操作を間違えた報告を防げます。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

再発防止の運用

確認依頼の文章テンプレートをスニペットとして保存しておきましょう。例:「ご確認お願いします。以下の操作で動作確認をお願いできますか?①上部目次の各リンクをクリック ②クリック後、タイトルがヘッダーに隠れずに見えるかご確認 ③問題があればスクリーンショットをご共有ください」。TextExpanderやclipy等に登録しておくと再利用が簡単です。

ギガサイト便などの共有サービスを使っている場合、URL発行時のメモ欄や説明文に確認依頼の要点を入れておくと、別途メッセージを送らなくても相手が確認ポイントを把握した状態でHTMLを開けます。共有ページに説明を埋め込む機能があるサービスを選ぶと運用が楽になります。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

よくある質問

相手から「目次がどこにあるかわからない」と返信があった場合は?

「ページを開いて上にスクロールすると、青いリンクが縦に並んだ一覧があります。そこの各リンクをクリックしてください」のように、目次の視覚的特徴を言葉で描写すると非エンジニアにも伝わりやすくなります。

相手が「問題ない」と返信したが自分には再現する場合、どうすれば原因を絞り込めますか?

相手のデバイス・ブラウザ・OSバージョンを聞いた上で、同じ環境をChrome DevToolsのDevice emulatorで再現して確認してください。環境を合わせれば挙動の違いを自分でも再現・確認できるようになります。

修正後に再度確認を依頼するとき、以前の依頼文と何を変えるとよいですか?

「先日ご報告いただいた目次のスクロールずれを修正しました。同じ操作でご確認いただけますでしょうか」と修正内容を一言添えると、相手が何を確認すればよいかがすぐわかります。前回と同じURLか変わったURLかも明記してください。

関連記事

「トラブルシュート」の記事をもっと見る →