Skip to content

COMDOX-1472: Add ACCS onboarding documentation#803

Draft
bdenham wants to merge 9 commits intoreleasefrom
comdox-1472-onboarding
Draft

COMDOX-1472: Add ACCS onboarding documentation#803
bdenham wants to merge 9 commits intoreleasefrom
comdox-1472-onboarding

Conversation

@bdenham
Copy link
Copy Markdown
Collaborator

@bdenham bdenham commented Mar 29, 2026

Purpose of this pull request

This pull request addresses documented gaps identified in the ACCS onboarding checklist gap analysis (COMDOX-1472). It adds six new pages and enhances two existing pages so readers can follow the full ACCS onboarding journey end to end. It also updates the Storefront Setup sidebar, cross-links from prerequisites, and includes the ProseFlow component so new pages have consistent typographic rhythm and the change set is self-contained against the release base branch.

New pages

  • Pre-onboarding — Stakeholder alignment, business/use-case definition, architecture planning, infrastructure readiness, compliance review, and a technical access checklist.
  • Experience Cloud access — Adobe Experience Cloud access, Admin Console setup, role-to-responsibility matrix, and how services connect to the EDS storefront.
  • Commerce Cloud Manager — Credit validation, instance creation (production and staging), and environment ID retrieval.
  • App Builder — Workspace setup for storefront event handling and extensibility.
  • API Mesh — Configuration, when to use it, CDN/Fastly considerations, and VCL workarounds for header limits.
  • Custom frontend — Custom React/Next.js guide: drop-in packages, import maps, SDK initialization (initializers.register()), and provider.render() mounting patterns.

Enhanced pages

  • Content delivery network — DNS and custom domains (record types, CNAME/apex guidance, TLS management).
  • Configuration hub — Callout directing ACCS users to the pre-onboarding checklist.

Other changes

  • Sidebar entries for Pre-onboarding, Experience Cloud access, Commerce Cloud Manager, App Builder, API Mesh, and Custom frontend under Storefront Setup.
  • Cross-links in prerequisites to pre-onboarding and Experience Cloud access.
  • ProseFlow.astro copied from ia-updates for use on new pages.

Associated JIRA ticket

COMDOX-1472

Affected pages

What's New highlights

whatsnew
Added new topics:

Test plan

  • Verify all six new pages render without build errors
  • Confirm sidebar links for all new pages resolve correctly
  • Check that cross-links in prerequisites.mdx and configuration/index.mdx point to the correct pages
  • Review DNS section additions in content-delivery-network.mdx for accuracy
  • Validate ProseFlow component renders correctly on new pages

bdenham added 3 commits March 29, 2026 14:34
Copies ProseFlow.astro from ia-updates so the new onboarding/setup
pages can use it without depending on the ia-updates branch.

Made-with: Cursor
@bdenham bdenham self-assigned this Mar 29, 2026
@bdenham bdenham added major-update Significant original updates to existing content new-topic A major update published as an entirely new document labels Mar 29, 2026
@bdenham bdenham marked this pull request as draft March 29, 2026 20:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

major-update Significant original updates to existing content new-topic A major update published as an entirely new document

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant