Appearance
トラブルシューティング
docs/troubleshooting/ は、障害や不具合の調査手順、既知のエラーと復旧方法を置くカテゴリです。原因調査の入口として使い、恒久対策が決まったら該当する正本にも反映します。
このカテゴリに置くもの
- 既知エラーの症状、原因、確認コマンド、復旧手順
- Local Sites、IDE、外部 API、IMAP など環境依存の調査メモ
- サイト停止や障害予防に関する初動手順
- 再発時に参照する切り分け観点
通常のセットアップ手順は 環境、恒常的な運用ルールは 運用 に置きます。
本番作業中に障害予防や初動対応を確認する場合は、まず 本番デプロイ の入口から作業全体の位置づけを確認し、症状別の詳細としてこのカテゴリを参照します。
正本ドキュメント
| 症状・目的 | 正本 |
|---|---|
| サイト停止予防 | サイト停止防止ガイド |
| Local Sites / FastCGI timeout | Local Sites FastCGI timeout |
| IDE ReflectionClass エラー | IDE ReflectionClass エラー |
| Stripe API キー設定 | Stripe API キー設定 |
| P-WORLD IMAP 0 件 | P-WORLD IMAP 0 件調査 |
補助資料・履歴資料の扱い
調査ログは、再発時に役立つ確認順だけを残します。恒久対策や現在の設定値は、このカテゴリだけに閉じず、該当する環境・運用・設計の正本にも反映してください。