Your achievements

Level 1

0% to

Level 2

Tip /
Sign in

Sign in to Community

to gain points, level up, and earn exciting badges like the new
Bedrock Mission!

Learn more

View all

Sign in to view all badges

AEM Components - Markdown Documentation

Avatar

Community Advisor

15-08-2022

 

readme-3.gif


[AEM Components : Markdown Documentation as help documentation]

  by Arun Patidar

Overview

The Granite UI widget fieldDescription property is used to add helpful tooltips to your dialog fields but in some cases, you might need to add details documentation about the component, whether it’s technical or for Authoring instructions.

Then you may use dialogs helpPath property to link component document to the dialog, the path could be github page or confluence page or any other page. For instance core components uses adobe documents as help document for the component, example Core Image component

 

jcr:title="Image"
sling:resourceType="cq/gui/components/authoring/dialog"
helpPath="https://www.adobe.com/go/aem_cmp_image_v3"

 

Wondering if the this documentation can be part of AEM or dialog itself.

Ahmed Musallam has created a blog about reading readme file and generating document when click on help link. You should check this out at https://blogs.perficient.com/2019/03/27/simple-markdown-documentation-for-your-aem-components/

 

My Approach is slightly different, I used client side javascript to read README file, convert to HTML and showing as popup.

 

More information at https://aemlab.blogspot.com/2022/08/component-readme-doc.html 


Q&A

Please use this thread to ask questions relating to this article

1 Comment