AEM Documentation Journeys

Last update: April 17, 2024

CREATED FOR:

  • Admin
  • Developer
  • User
  • Leader

Documentation Journeys provide a narrative structure within AEM documentation by tying together complex and disparate features to solve a business goal in a best-practices fashion. Designed with AEM beginners in mind, journeys introduce the concepts and features to achieve a goal from A to Z.

What is a Documentation Journey?

A Documentation Journey ties together many different and complex topics and features by providing a narrative that helps the reader, who can be new to AEM, understand and solve a business problem from beginning to end, while assuming minimal prior topic or AEM knowledge.

Documentation Journeys contrast with AEM’s existing technical docs that primarily focus on a single feature and documentation of tasks, assuming familiarity with AEM. By focusing on the concepts and deferring in-depth details to the existing technical documentation, Documentation Journeys give readers new to AEM a place to begin understanding how the platform can be used by using best practices to address common business needs and workflows. For this reason, Documentation Journeys serve as a complement to and not a replacement for AEM’s existing technical documentation.

Learning By Narrative

AEM has a rich and powerful feature set that can be overwhelming to new (and sometimes experienced) users. By starting each journey with a clear business objective rather than technical requirements, a journey tells a narrative leading the reader through the AEM concepts and features that work together to achieve the business goal.

By telling a story, the reader better understands how different parts of AEM work together to solve the problem at hand and perspective is maintained. Thus the reader can see the business objective forest for the feature trees.

Focus on Concepts not Features

To maintain focus on the narrative, Documentation Journeys emphasize concepts in AEM instead of dwelling on technical features. Recognizing that it is more important that the reader is familiar with how AEM solves a particular problem rather than worrying about which checkboxes to click, the journey keeps the reader moving forward through the narrative, illustrating how to link together multiple important concepts so achieve the overall goal.

Journeys ensures that the reader knows how AEM can solve a problem instead of worrying about each option to click. If the reader wants to take a deeper dive and learn more technical detail or what additional options can do, every part of the journey links to related, exhaustive technical documentation.

Best Practices Orientation

Documentation Journeys are designed around best practices principles, informed by Adobe’s latest research, proven implementation experience from Adobe services, and feedback from customer projects.

If you want to know how Adobe recommends how to solve a business case with AEM, Documentation Journeys are where to start.

How is a Documentation Journey Structured?

A Documentation Journey serves as a best practices-based introduction to how AEM solves common business problems. For this reason, each journey is designed with readers new to AEM in mind, laying out the business problem, describing any necessary theory, and then giving a step-by-step overview of how AEM solves the problem. Because of the comprehensive nature of a journey, it can be useful to readers new to AEM and experienced users.

A typical Documentation Journey has the following parts.

  • Overview of the goals of the journey and the intended audience
  • Description of business problem
  • Description of any theory necessary to solve the problem
  • Prerequisites and requirements
  • Description of intended audience
  • Implementation steps

A Documentation Journey’s goal is to familiarize the reader with the basics of how AEM uses different features and tools to solve a single business problem. For this reason, the implementation steps illustrate the most common usage patterns and most important features and options. Detailed configuration options are linked to in the technical documentation for further reading.