Adobe knows that Adobe Experience Manager users are working in highly competitive environments, striving to create digital experiences that set them apart from their competitors. Therefore it is vital that when Adobe delivers advanced new tools in AEM, that these tools are complemented with accurate and clear documentation to allow the customer to immediately use their AEM investment and maximize ROI.
The goal of the AEM documentation is to put documentation into the hands of AEM users as soon as possible. Therefore, Adobe prioritizes accurate, usable documentation and strive to continually update and improve it.
In the interest of continually improving AEM documentation, the entire community of AEM users is welcome to contribute to the documentation. Be it through pull requests or issues, improvements to the documentation can be corrections, clarifications, expansions, and additional examples.
While Adobe welcomes contributions to our documentation, any contribution to the AEM documentation, either in the form of a pull request or an issue, should conform to our contribution and documentation standards.
Contributions that do not meet these standards may be rejected.
AEM documentation covers standard use cases. Use cases beyond the scope of standard installation and usage of the product are not part of AEM documentation.
AEM documentation covers standard use cases. For this reason, bugs, effects caused by bugs, and workarounds for bugs are usually not documented.
Exceptions to this rule apply to the release notes where known issues can be listed with possible solutions that have been approved by AEM Product Management.
Any ideas you may have to improve AEM documentation are welcome as contributions. However comments, issues, and pull requests are intended for contributions only. They are not intended to be used to answer your questions about how to use AEM, implement your AEM project, or solve technical problems.
Any questions about the usage of AEM or technical errors you may have should be reported through the normal support process via the Experience Manager Support portal or discussed in the Experience Manager community.
AEM documentation contributions are not a replacement for Adobe Customer Support and any such contributions seeking answers to support-related questions will be rejected.
If you create an issue to suggest improvements to the documentation, you must include links to the pages affected. If you create an issue by using the Edit this page link on a documentation page, the issue is created with a link to the page automatically.
This does not apply to pull requests since pull requests by their nature reference the affected pages.
We ask that any contributions to our documentation follow certain style guidelines.
Following these guidelines makes the review of your contribution easier and therefore integration into our documentation is faster.
- AEM documentation is authored and maintained in US English.
- Keep sentences as simple as possible.
- Keep the language clear and concise.
Remember, readers of AEM documentation are worldwide and cannot be expected to be native or fluent English speakers. Avoid colloquialisms and keep the language as clear and simple as possible.
The Microsoft® Manual of Style is a freely available documentation style guide that focuses on software documentation and AEM documentation follows this guide wherever possible.
| Item | Style |
|---|---|
| UI Element or option | bold |
| Filename, path, user-input, parameter-values | monospaced |
| Code, command line | Code Block |
Screenshots are to be used judiciously and only when a textual description is insufficient.
Do not use markers or other annotations in screenshots (like red frames, arrows or text). This way the screenshots are easier to reuse or replicate in localized versions of the documentation.
Try to avoid any direct references to a specific version throughout the documentation content whenever possible. This makes the documentation more flexible and extensible for future versions.
The product should always be referred to by its full name Adobe Experience Manager for the first time in an article and can thereafter be referred to as AEM.
Do not use Day, Day Software, CQ, and CRX except where unavoidable such as in class names or referring to the history of AEM.