AEM ドキュメントのジャーニー aem-documentation-journeys
ドキュメントジャーニーでは、ビジネス目標を解決するために、ベストプラクティスに従って複雑で種々異なる機能を組み合わせることで、AEM ドキュメントにストーリー構造を提供します。AEM の初心者を念頭に置いて設計されたジャーニーでは、A から Z の目標を達成するための概念と機能を紹介しています。
ドキュメントジャーニーとは what-is
ドキュメントジャーニーは、AEM を初めて使用するユーザーが、以前のトピックや AEM の 知識が最小限のものだという前提で、最初から最後までビジネス上の問題を理解して解決するのに役立つ物語を提供し、様々な複雑なトピックや機能をつなぎ合わせて説明しています。
ドキュメントジャーニーは、AEM の既存の技術ドキュメントが、AEM に慣れていることを前提に、主にタスクの単一の機能と文書化に焦点を当てているのとは対照的です。ドキュメントジャーニーでは、概念に重点を置き、詳細な説明は既存の技術ドキュメントに委ねることで、AEM を初めて使用する読者が、一般的なビジネスニーズやワークフローに対処するベストプラクティスを使用してプラットフォームを活用する方法を理解する場を提供します。このため、ドキュメントジャーニーは AEM の既存の技術ドキュメントの補完として機能し、置き換えるものではありません。
物語で学ぶ narrative
AEM には、豊富で強力な機能セットがありますが、初めてのユーザーは(または経験豊富なユーザーでも)圧倒されてしまうかもしれません。技術的な要件ではなく、明確なビジネス上の目的を持って各ジャーニーを開始することで、ビジネス目標を達成するために連携する AEM の概念と機能をユーザーに物語として説明します。
物語を語ることで、AEM の様々な部分がどのように連携して現在の問題を解決し、どのように全体像が維持されるかをより深く理解できます。これによりユーザーは、機能の木々ではなく、ビジネス目標の森を見ることができます。
機能ではなく概念に焦点を当てる concepts
物語に焦点を当てるため、ドキュメントジャーニーでは、技術的な機能に重点を置く代わりに、AEM の概念を重視しています。どのチェックボックスをクリックするべきかを気にかけるよりも、AEM が具体的な問題をどのように解決するかをユーザーに理解してもらうことが重要だとの認識に立ち、ジャーニーでは、全体的な目標を達成するために複数の重要な概念をどうリンクするかを説明しながら、ユーザーが物語を進めていけるようになっています。
ジャーニーは、ユーザーが、各オプションをクリックするべきか悩むのではなく、AEM がどのように問題を解決するかを確実に理解できるようにします。さらに深く掘り下げて技術的な詳細を知りたい場合や、他のオプションで何が出来るかについて知りたい場合は、関連する包括的な技術ドキュメントにジャーニーのあらゆる部分からリンクできます。
ベストプラクティスの方向性 best-practices
ドキュメントジャーニーは、アドビの最新の調査、Adobe サービスによる実証済みの実装経験、お客様のプロジェクトからのフィードバックをもとに、ベストプラクティスの原則に基づいて設計されています。
AEM を使用してビジネス事例を解決するためにアドビが推奨する方法を知りたい場合は、ドキュメントジャーニーから開始してください。
ドキュメントジャーニーの構造 structure
ドキュメントジャーニーは、AEM が一般的なビジネス上の問題をどのように解決するのかを、ベストプラクティスに基づいて紹介するものです。そのため各ジャーニーは、AEM を初めて使用するユーザーを念頭に置いて設計されており、ビジネス上の問題を提起し、必要な理論を説明した上で、AEM が問題をどのように解決するかを段階的に説明しています。ジャーニーは包括的なものなので、AEM を初めて使用する読者だけでなく、経験豊富なユーザーにとっても役に立ちます。
典型的なドキュメントジャーニーは、次のような部分で構成されています。
- ジャーニーの目標と対象オーディエンスの概要
- ビジネス上の問題の説明
- 問題解決に必要な理論の説明
- 前提条件と必要条件
- 対象オーディエンスの説明
- 実装の手順
ドキュメントジャーニーの目標は、AEM が様々な機能やツールを使用して、一つのビジネス上の問題をどのように解決するかについて、その基本をユーザーに知ってもらうことです。このため、実装の手順では、最も一般的な使用パターンと、最も重要な機能およびオプションを説明しています。詳細な設定オプションについては、リンクされている技術ドキュメントを参照してください。
ドキュメントジャーニーの対象オーディエンス who
AEM ドキュメントジャーニーの主な目的は、AEM を初めて使用するユーザーが、システムの様々な強力な機能を組み合わせて、一般的なビジネス上の問題をどのように解決できるかを、物語形式で理解できるようにすることです。
AEM を初めて使用し、特定のビジネス事例を念頭に置いていて、AEM がその事例をどう解決するかの概要を知りたい場合は、ドキュメントジャーニーを開始してください。
ただし、AEMのユーザーには様々なタイプがいて、ニーズや期待も異なります。次に例を示します。
- 管理者
- デベロッパー向け
- コンテンツ作成者
- 翻訳スペシャリスト
- コンテンツアーキテクト
各ジャーニーは、ジャーニーの対象オーディエンスを明確に示す文章から始まります。他の人から孤立して働く人はいないので、システムユーザーやペルソナの入力を必要とする場合は、ジャーニー内で明確に説明されます。
ドキュメントジャーニーは、AEMドキュメントにどのように適合しますか? compare
ドキュメントジャーニーは、既存の AEM の技術ドキュメントおよびチュートリアルを補完することを目的としています。例えば、ジャーニーでは概念を紹介し、技術ドキュメントでは必要とされる詳細な設定オプションを、そしてチュートリアルでは特定の設定手順を説明しています。
どのようなジャーニーがありますか? journeys
ドキュメントジャーニーがいくつか用意されています。各ジャーニーは物語としてデザインされているので、AEM のコンテキストでトピックを完全に理解するには、概要から順を追ってお読みください。