Tool to generate authoring docs for Content Fragment Model

[Mahesh_Gunaje]

Hello Team,

For my project, I need to create many content fragment models. Once I create all these CFM, I need to create implementation guide (for developers) and authoring guide for AEM authors to refere these docs while creating the CF.

Wanted to know, is there any tool to generate implementation guide as well as authoring guide from Content fragment model xml file?

cc @arunpatidar @SantoshSai  @giuseppebag  @HrishikeshKagne 

Thanks in advance

[giuseppebag]

hi @Mahesh_Gunaje,

AFAIK, there is no out-of-the-box tool designed to automatically generate implementation guides or authoring guides from Content Fragment Model XML files in AEM. I see two possible approaches here: manual and programmatic.

You could create standardized documentation templates that include:

For Implementation Guides:

• Model path and configuration location

• Data type definitions for each field

• Property names and validation rules

• GraphQL query examples

• Fragment reference relationships​

For Authoring Guides:

• Field labels and descriptions

• Required vs. optional fields

• Character limits and validation requirements

• Visual examples of completed fragments

• Usage guidelines for variations​

Alternatively, you could develop a custom documentation generator. This would involve creating a Java or Node.js script that reads CFM XML files from /conf/<project>/settings/dam/cfm/models/, parses the structure, and outputs documentation in your desired format.