HTMLソースのコメントに残る社内メモ・TODOを公開前に消す

コメントに残りがちな情報

HTMLのコメントは画面に表示されませんが、ソースを開けば誰でも読めます。制作の過程で書いた『この金額は社内確認待ち』『担当の○○さんに要確認』といったメモが、そのまま公開されてしまうことがあります。

ほかにも、検討中で却下になった文言、別案の価格、社内システムのURL、デバッグ用の出力など、外に出すべきでない情報がコメントやスクリプトに残りがちです。本文だけ整えても、裏側に痕跡が残ります。

公開ページは関係者以外も見られる前提です。ソースに社内向けの記述が残っていると、意図しない相手にプロジェクトの内情が伝わるおそれがあります。

なぜ見落とすのか

コメントは画面に出ないので、完成画面を確認しただけでは存在に気づけません。プレビューで問題なく見えても、ソースには消し忘れが残っていることがあります。

制作中は『あとで消す』つもりで書いたメモが、納期に追われてそのまま公開されるケースが典型です。一時的なメモほど消し忘れやすいという矛盾があります。

AIや既存テンプレートから生成したHTMLには、生成時の説明コメントやプレースホルダが残ることもあります。自分で書いた覚えがなくても、コメントの確認は必要です。

よくあるNG例と安全な直し方

HTMLソースのコメントに残る社内メモ・TODOを公開前に消すでは、「検索に出さない」と「見られないようにする」を混同しないことが重要です。noindexやrobots.txtは検索エンジンへの指示であり、アクセス制限そのものではありません。

安全に共有するには、誰に見られると困るかを先に決め、URL共有だけで足りるのか、認証や期限が必要なのかを選びます。共有相手と機密度が決まったら、URLのみ・パスワード・メール認証・会社ドメイン認証のどれで渡すかを選びます。

• NG: 機密情報入りHTMLを認証なしURLで共有し、noindexだけで安心する
• OK: パスワード・メール認証・会社ドメイン認証で閲覧者を絞る
• NG: テスト用APIキーや社内URLをHTML内に残したまま渡す
• OK: 公開前に外部送信先、秘密情報、フォーム送信先を確認する

公開前に検出する手順

公開前に、ソースから不要なコメントやデバッグ記述を洗い出します。次の手順で確認すると漏れにくくなります。

検索でまとめて洗い出すのがコツです。目視だけで探すと、長いソースの中ほどに残ったメモを見落としやすいためです。最後はブラウザのソース表示で実物を確認します。

1. エディタでHTMLを開き、コメント記号で全文検索して該当箇所を一覧化する
2. TODO・FIXME・確認・仮・debug などのキーワードでも検索する
3. スクリプト内のコンソール出力やデバッグ用の記述を確認する
4. 残す必要のないコメントはすべて削除する
5. 削除後にブラウザでソースを表示し、社内向け記述が消えたか目視で確認する

CSS・JSや隠し要素も確認する

情報が残るのはHTMLコメントだけではありません。CSSやJavaScriptのファイルにも、コメントや使っていない設定値、開発用のメモが残ることがあります。ZIPで一式を共有する場合は、これらも対象に含めます。

画面で非表示にしている要素(display:noneなどで隠した部分)も、ソースには残っているため読み取れます。『見えないから消した』ではなく、ソースから消すことが必要です。

デバッグ用にコンソールへ出力する記述は、開発者ツールを開いた人に内容が伝わります。公開版では出力を止めるか削除しておきます。

仕組みで防ぐ工夫

毎回手作業で確認するのは漏れが出ます。公開前チェックの定型リストを用意し、コメント検索を必ず通す手順にしておくと、消し忘れが減ります。

noindexが付いていても、これは検索結果に出さないだけで、ソースを読まれること自体は防げません。アクセスを制限したいなら認証を併用し、見せたい相手を絞ります。

ギガサイト便では認証方式で閲覧者を限定でき、公開期限で公開を区切れます。ただしソースのコメント掃除は公開前の作業です。コメントを消したうえで、必要なら認証で範囲を絞って共有してください。