AEM Documentation Journeys
A Documentation Journey ties together many different and perhaps complicated 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 are designed around best practices principles, informed by Adobe’s latest research, proven implementation experience from Adobe consultants, and feedback from customer projects.
If you want to know how Adobe recommends how to solve headless business cases with AEM, AEM Headless Journeys are where to start.
Audience
This journey is designed for the translation specialist persona, often referred to as the Translation Project Manager or TPM. This journey lays out the requirements, steps, and approach to translate headless content in AEM. The journey may define additional personas with which the translation specialist must interact, but the point-of-view for the journey is that of the translation specialist.
This journey assumes the reader has experience translating content on a large CMS system, but assumes no knowledge of headless technology or AEM.
The following are the personas that interact in this journey.
Persona | Description | Role in Journey |
---|---|---|
Translation Specialist | Defines what content should be translated and manages those workflows | Audience of this journey |
Content Author | Creates and manage content that is delivered headlessly | Content Authors create content that the translation specialist must translate. |
Administrator | Manages the base setup and configuration of AEM | The translation specialist works with the administrator to make configuration changes needed for translation such as installing a translation connector. |
Content Architect | Analyzes the requirements for the data that must be delivered headlessly and defines the structure for this data | Translation specialists work with the content architect to define the organization of the content so it can be easily translated. |
Information in this journey can be useful to all personas, but some information may be superfluous to certain roles. Stay tuned for forthcoming journeys covering additional roles.
The Headless Translation Journey
You will explore many topics in this journey. The following articles give you foundational knowledge of translating headless content in AEM and link out to detailed technical documentation.
Although you can go directly to a particular part of the journey, many concepts build on ones in previous articles. Therefore if you are new to headless translation in AEM, Adobe recommends that you start at the beginning and progress sequentially.
# | Article | Description |
---|---|---|
0 | AEM Headless Translation Journey | This document |
1 | Learn about headless content and how to translate it in AEM | Learn headless concepts, how they map to AEM, and the theory of AEM translation. |
2 | Get started with AEM headless translation | Get to know how to organize your headless content and how AEM’s translation tools work. |
3 | Configure the translation integration | Learn how to connect AEM to a translation service. |
4 | Configure translation rules | Learn how to define translation rules to identify content for translation. |
5 | Translate content | Use the translation integration and rules to translate your headless content. |
6 | Publish translated content | Learn how to publish your translated content and update the translation when the underlying content is updated. |
What’s Next
You are now ready to get started on your Adobe headless translation journey. We encourage you to continue on to the next part of the journey and read the article Learn about headless content and how to translate it in AEM