ページ先頭の導入部分は、そのページが何を扱い、誰向けで、読み続けるべきかを伝えます。このページでは、コンテキスト、イントロダクション、想定読者の 3 つを扱います。
ページタイトルの直後に置く導入段落です。手順、概念、FAQ、リファレンスなど、読者がそのコンテンツから何を得られるかを説明します。
使用箇所: How to、Configuration、FAQ、Concept、Reference、Tutorial
構成はコンテンツタイプごとに異なります。
- How to: 手順と、それが何を達成するかの導入段落です。セクション見出しにない背景を書きます。手順の直前に置く場合はコロンで終え、コンテキストと手順の間に注記などがある場合は句点で終えます。番号付き手順が文を完成させる、途中までの文は使わないでください。
- Configuration: タイトル直後の段落で機能を紹介し、読者が見る設定の位置づけを示し、関連ドキュメントへリンクします。
- FAQ: そのセクションと、読者がそこから何を得られるかの導入段落です。
- Concept: 読者がこの情報を知るべき理由の短い説明です。
- Reference: ページ上の情報を、いつ、なぜ使うかの導入段落です。
- Tutorial: 読者の目標と、チュートリアルでどう達成するかの導入段落です。想定読者を入れることも検討します。
コンテンツが扱う内容の概要です。長い文書で、読む時間を使うべきかを読者が判断できるようにします。
使用箇所: リファレンスアーキテクチャ、デザインガイド
半ページ以内、通常は 1〜3 段落です。最初の段落でトピックをすばやく明確に説明し、最後の段落で文書の内容を説明します。
例:
Cloudflare One は、企業のアプリケーション、ユーザー、デバイス、ネットワークを保護するセキュアアクセスサービスエッジ（SASE）プラットフォームです。Cloudflare One を段階的に導入すると、ハードウェアアプライアンスや個別ソリューションの寄せ集めから離れ、セキュリティとネットワーキングの機能を 1 つの統合コントロールプレーンにまとめられます。こうしたネットワークとセキュリティの変革は、現代の企業が直面する次のような課題への対応に役立ちます。
- Zero Trust の考え方で、任意のユーザーから任意のリソースへのアクセスを保護する
- 複数チャネルのフィッシングやランサムウェアなど、サイバー脅威から守る
- 規制への準拠と情報漏えい防止のためにデータを保護する
- オフィス、データセンター、クラウド環境をまたぐ接続を簡素化する
Cloudflare One は、Cloudflare の connectivity cloud 上に構築されています。これは、あらゆるネットワーク（企業とインターネット）、クラウド環境、アプリケーション、ユーザーの間の any-to-any 接続を可能にする、プログラム可能なクラウドネイティブサービスの統合インテリジェントプラットフォームです。世界数百都市にデータセンターを持ち、over 13,000 network peers と相互接続する、最大級のグローバルネットワークの 1 つです。
この文書は、SASE アーキテクチャを目指す組織向けのリファレンスアーキテクチャを説明し、Cloudflare One がこうしたセキュリティとネットワーキングの変革をどう実現するかを示します。
コンテンツの対象者と、読者が学ぶ内容の要約です。コンテキストまたはイントロダクションと合わせると、ページの内容と、自分の役割に関係するかを把握できます。
使用箇所: リファレンスアーキテクチャ、デザインガイド
小見出し Who is this for? で始め、1〜3 段落に収めます。最初の段落で、この文書の想定読者の種類を説明します。既存の知識に依存する場合は、先に読めるリソースを 3〜5 件リンクします。最後の段落に、読者が学ぶ内容を 2〜3 件の具体的な箇条書きで書きます。
例:
Who is this for?
このリファレンスアーキテクチャは、自組織の既存インフラに何らかの責任または知識がある IT またはセキュリティの担当者向けです。ハイブリッドワークの保護に重要な技術、つまり ID プロバイダー（IdP）、ユーザーディレクトリ、シングルサインオン（SSO）、エンドポイントセキュリティまたは管理、ファイアウォール、ルーター、個別ソリューションの経験があると役立ちます。
Cloudflare の基礎理解を深めるには、次のリソースをおすすめします。
- What is Cloudflare? | ウェブサイト（5 分で読める）または動画（2 分）
- Solution Brief: Cloudflare One（3 分で読める）
- Whitepaper: Reference Architecture for Internet-Native Transformation（10 分で読める）
- Blog: Zero Trust, SASE, and SSE: foundational concepts for your next-generation network（14 分で読める）
このリファレンスアーキテクチャを読むと、次のことが分かります。
- Cloudflare One が、組織の従業員、デバイス、アプリケーション、データ、ネットワークをどう保護するか
- Cloudflare One が既存インフラにどう収まるか、および SASE アーキテクチャへの移行の進め方
- Cloudflare One の導入計画の立て方