Eds migration#339
Merged
Merged
Conversation
Made-with: Cursor
Made-with: Cursor
Made-with: Cursor
Made-with: Cursor
Made-with: Cursor
- Add a custom SpectaQL theme and grunt override so the usual HTML documentation pipeline produces a Markdown fragment instead of styled HTML. - Replace the previous fetch/enhance/static-HTML scripts with a generator script wired to that Markdown-oriented configuration. - Add the SpectaQL dependency, minimatch override, and tracked package-lock; adjust gitignore for npm artifacts. - Remove vendored introspection caches and legacy HTML-oriented configs (YAML bundles, large schema JSON, comdox partials).
- Include the generated Markdown fragment from SpectaQL on the GraphQL reference page so content matches Edge Delivery authoring constraints. - Document Edge Delivery three-server workflow and npm lint commands in README. - Move auth snippets to src/pages/includes and replace DiscoverBlock sections with Fragment includes on API topics. - Refresh links from old static GraphQL HTML URLs to in-repo reference anchors. - Remove committed static GraphQL SpectaQL HTML under static/graphql-api; drop obsolete src/_includes copies from the prior layout.
dshevtsov
added
migration
major-update
jiangy10
approved these changes
May 6, 2026
jiangy10
left a comment
jiangy10
left a comment
There was a problem hiding this comment.
Approved PR, but please do not merge and close it for now. Our team need to make a final check to remove everything related to gatsby and fix the redirect on fastly for production
github-project-automation
Bot
moved this from 📋 Needs Review
to 👍 Approved
in Commerce - Pull Requests
…s into eds-migration
…g in SpectaQL generator
github-project-automation
Bot
moved this from 👍 Approved
to 🏁 Done
in Commerce - Pull Requests
github-project-automation
Bot
moved this from 🏁 Done
to 🧑💻 In Progress
in Commerce - Pull Requests
Co-authored-by: Cursor <cursoragent@cursor.com>
|
Gatsby Related Files Cleaned |
github-project-automation
Bot
moved this from 🧑💻 In Progress
to 🏁 Done
in Commerce - Pull Requests
imgbot Bot
pushed a commit
to commerce-docs/commerce-services
that referenced
this pull request
May 8, 2026
Eds migration
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
2 participants
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
This pull request migrates the Merchandising Services documentation from the Gatsby-based Adobe I/O theme stack to Adobe Edge Delivery Services with the Adobe Developer Site tooling (
adp-devsite-utils). It replaces theme-specific navigation and build steps withsrc/pages/config.md–driven structure, switches the project to npm (includingpackage-lock.json), and updates CI workflows for linting, validation, staging, and deployment. The Merchandising GraphQL API reference is generated as Markdown (SpectaQL markdown theme) intosrc/pages/includes/autogenerated/merchandising-api.mdinstead of committing large static HTML bundles understatic/graphql-api/. Shared snippets move fromsrc/_includes/intosrc/pages/includes/, images move from_images/toimages/, and redundant Gatsby overrides, checked-in schema artifacts, and legacy workflows are removed. Config-driven navigation replaces deletedsrc/data/navigationJavaScript.tests/config.test.jsvalidates the table of contents configuration.Affected pages
This change touches essentially the entire published site under the Commerce Services path. Primary entry and major sections:
Preview on stage
Additional information
major-updatelabelWhat's New highlights
whatsnew
Updated Adobe Commerce Merchandising Services documentation for the Adobe Edge Delivery Services developer site platform, including revised local development setup, site navigation, and Merchandising GraphQL API reference generation.