問題

コマンド中心の記事は検索流入を得やすい一方、sudo、削除、設定変更などを文脈なしで載せると読者環境で事故につながります。

同じコマンドでも、OS バージョン、権限、現在ディレクトリ、サービス状態で結果が変わるためです。安全性を判断できない記事は、長期的に信頼を失います。

信頼を上げる書き方

シェル系の技術記事では、コマンド単体より実行コンテキストの提示が重要です。実務では次の3点を最低基準にすると安定します。

  1. 前提条件
    • 対象OS/バージョン、必要権限、作業ディレクトリ
  2. 影響範囲
    • 何が変更されるか（ファイル、サービス、パッケージ）とロールバック可否
  3. 検証手順
    • 実行直後に確認すべきポイント（状態、ログ、疎通）

この形式にすると、読者は自分の環境に適用できるかを素早く判断できます。

例

PM2 再起動ガイドの例:

# 前提条件
# - Ubuntu 22.04
# - プロジェクトルート: /srv/myapp
# - pm2 導入済み、プロセス名は myapp
cd /srv/myapp
pm2 restart myapp

影響範囲:

  • myapp プロセスのみ再起動
  • ソースコードやDBスキーマは変更しない
  • 再起動中に短い応答遅延が起きる可能性あり

検証:

pm2 status myapp
pm2 logs myapp --lines 20
curl -I http://127.0.0.1:3000

確認基準:

  • status が online
  • 直近20行のログに startup error がない
  • HTTP ステータスが 200 または 302

まとめ

シェルコマンド記事のSEO信頼は、コマンドだけでなく前提条件・影響範囲・検証手順をセットで示すことで強化されます。

関連記事