# AWSガイドの書き方と確認方法

cloudconsole.devのガイドは、AWSのエラー、CLIコマンド、CloudWatchアラーム、Logs Insightsのクエリ、リージョン、各種の手順を扱っています。このページでは、ガイドの書き方と確認方法、誤りを修正してもらう方法を説明します。ガイド自体は英語です。

## ガイドができるまで

1. **1ページに、実際の質問を1つ**

   各ガイドは、エンジニアが実際に検索する事柄を1つだけ扱います。エラーメッセージ、CLIコマンド、CloudWatchアラーム、Logs Insightsのクエリ、リージョン、手順のいずれかです。質問は実際の検索候補から選んでおり、言い換えで水増ししたキーワードリストではありません。まず短い答えを示し、そのあとに詳細を書きます。

2. **AWSのドキュメントを情報源に**

   各ガイドは、根拠とするAWSのドキュメントを「Sources」欄でリンクしています。AWSが変更しうる上限や既定値は「既定では」「執筆時点では」と書くか、記載しません。

3. **すべてのCLIコマンドを自動で確認**

   ガイドを公開する前に、ビルドがすべての`aws …`コマンドをAWS CLI自身のサービス定義（botocore）と照合します。APIに存在しないフラグがあればビルドは失敗します。最終の全件確認：2026年11月17日、全509本のガイドが合格。

4. **アラームの設定値はAWSの推奨どおりに**

   CloudWatchアラームのガイドでは、AWSが公開している「Recommended alarms」のメトリクス、統計、期間、しきい値、評価設定をそのまま記載し、そのページにリンクしています。どんなときに調整すべきかの解説は私たち独自のものです。

5. **今まさに直している人のために**

   最もよくある原因から順に、短い診断の手順、コピーできるコマンド、次にやりがちな失敗を書いています。削除や変更を伴うコマンドには注意書きを付けています。例では仮のアカウントとリソースを使っています。

6. **AIで下書きし、情報源で確認**

   ガイドはAIライティングツールの助けを借りて下書きし、引用しているAWSのドキュメントと上記の自動チェックで確認しています。自動チェックには、根拠のないリンク、存在しないフラグ、使い回しの定型文をはじくルールも含まれます。

## 方針

| | |
|---|---|
| 執筆者 | iPhone・Android向けのAWSアプリCloudConsoleを開発している英国の企業、Cloudconcur Ltdです。 |
| 独立性 | 私たちはAmazon Web Servicesとは提携していません。AWS自身のツールやほかの製品が適切な答えであれば、ガイドではそれを勧めます。CloudConsoleに触れるのは、デスクを離れているときの対処を扱う枠の中だけです。比較ページでは、CloudConsoleが私たちの製品であることを明記し、情報源を示しています。 |
| 無料、広告なし、Cookieなし | ガイドは無料で読め、広告はなく、Cookieも使いません。ページビューはCookieを使わないCloudflare Web Analyticsで計測し、ストアボタンのタップも同じくCookieなしで数えています（[プライバシーポリシー](https://cloudconsole.dev/ja/privacy)を参照）。 |
| 日付 | 各ガイドには最終更新日を表示しています。ガイドを修正したときは、その日付を更新します。 |
| 誤りの修正 | 誤りや古い情報を見つけたら、ページのアドレスを添えて[support@cloudconsole.dev](mailto:support@cloudconsole.dev)までお知らせください。確認できた誤りは修正し、ページを更新します。 |
| 引用 | ガイドは、AIアシスタントでの利用も含めて自由に引用していただけます。使用したページへのリンクをお願いします。 |

まずは[ガイド (EN)](https://cloudconsole.dev/guides/)をご覧になるか、[CloudConsoleについて](https://cloudconsole.dev/ja/about)をお読みください。

---

Source: https://cloudconsole.dev/ja/editorial

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
