Clarify Document Authoring vs AEM Sites content source#918
Merged
Conversation
Signed-off-by: Stephen Rugh <rugh@adobe.com>
bdenham
approved these changes
Jun 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose of this pull request
Adds contextual callouts across four pages to distinguish the Document Authoring (DA.live) path from the AEM Sites path when using Edge Delivery Services. Readers who land on boilerplate or get-started content for a DA.live project were getting confused when their project uses AEM Sites as the content source, since the instrumentation, setup steps, and Universal Editor workflow differ.
Changes:
boilerplate/universal-editor.mdx— note clarifying this page covers the DA.live content source; links to aem.live UE blocks guide for AEM Sites projectsget-started/before-you-start.mdx— DA.live access row now notes it applies to the Document Authoring path onlyget-started/create-storefront.mdx— note pointing AEM Sites users to the XCOM boilerplate and EDS+AEM docs on Experience Leaguemerchants/quick-start/universal-editor.mdx— tip callout summarizing both authoring approaches and linking each to its respective docsAffected pages
Pages that may need follow-up
A broader audit identified additional pages that are DA-centric without a scope callout. AEM Sites users landing on any of these could be misled, since block-table authoring, document metadata, and UE instrumentation all work differently when AEM Sites is the content source.
The common fix for each is a short Aside at the top (same pattern as
content-localization.mdx) scoping the page to Document Authoring and linking AEM Sites users to the equivalent AEM docs.