Enable inline XML comments in AEM Assets Author mode with Editor 2.0

Adobe Experience Manager (AEM) Assets Author mode supports inline XML comments in Editor 2.0 for content and tag reviews. By default, comments are available only in Reviewer mode, which can cause comments to be missed or incorrectly accepted when using tracked changes or manual comment workarounds. To resolve the issue, enable XML comments in Editor settings and verify that comments appear inline with tracked changes and tags.

Description description

Environment

Adobe Experience Manager (AEM) Assets

Issue/Symptoms

  • Proofreaders and authors need to add inline comments in AEM Assets Author mode to support content and tag reviews.
  • By default, comments are available only in Reviewer mode.
  • Using tracked changes and manual comment workarounds, such as inserting comments in brackets, can cause comments to be missed or incorrectly accepted during the content review process.
  • XML comments need to be added and viewed inline in Author mode.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Confirm that the environment uses Editor 2.0. If you’re unsure, check with your system administrator or refer to the environment’s release notes or configuration settings.
  2. In the AEM Web Editor in Author mode, open any DITA topic.
  3. Select More actions > Editor settings.
  4. Enable XML comments. You can also enable Tags to view DITA structure tags.
  5. In Author view, insert XML comments directly in the source or through the UI if available.
  6. Verify that comments appear inline in Author mode alongside tracked changes and tags.
  7. Test the workflow to ensure that comments, tags, and tracked changes are visible and function as intended.
recommendation-more-help
experience-cloud-kcs-help-kbarticles