Skip to content

Categories GraphQL storefront updates#325

Merged
meker12 merged 15 commits intomainfrom
meker12-patch-3
Feb 19, 2026
Merged

Categories GraphQL storefront updates#325
meker12 merged 15 commits intomainfrom
meker12-patch-3

Conversation

@meker12
Copy link
Copy Markdown
Contributor

@meker12 meker12 commented Feb 10, 2026

Purpose of this pull request

This PR improves the Merchandising Services documentation with enhanced category API content, updated GraphQL reference generation, and streamlined contributor guidance.

Staging previews:

Implement categories on the storefront
Updated schema reference

JIRA: DATA-6967, DATA-6949, DATA-6987 (release)

Categories storefront implementation

  • Add new CategoryProductView type section with examples for breadcrumb ancestor retrieval and family-based filtering
  • Expand CategoryTreeView type definition to include description, metaTags, and images fields; add query example for retrieving category details with metadata and images
  • Add tree diagrams to Navigation and CategoryTree query examples to visualize the returned hierarchies
  • Fix the "Retrieve specific category subtree" example response to include all child nodes referenced in childrenSlugs
  • Replace inline field tables with links to the Merchandising Services GraphQL API reference
  • Add linked table of contents for category types; consolidate and expand use case scenarios and performance considerations
  • Fix CategoryView2 typo to CategoryViewV2; fix categoryTree query signature to use required (!) types

GraphQL API reference and build tooling

  • Update README.md to consolidate the SpectaQL build instructions into a concise quick-start section with a pointer to spectaql/README.md for details
  • Update build scripts and metadata for enhanced schema generation

Other

  • Fix minor list numbering and indentation in api-testing.md
  • Fix syntax error in the use cases topic

Affected pages

What's New highlights

whatsnew
The Implement categories on the storefront section of the Merchandising Services API Developer Guide now documents the new CategoryProductView type, expands CategoryTreeView field details, adds tree diagrams for query examples, and consolidates use case scenarios. These updates make it easier to implement and query category data in your storefront integrations.

Fix markdown syntax to display the product query example for Complex products.
@meker12 meker12 self-assigned this Feb 10, 2026
@meker12 meker12 added the bug Something isn't working label Feb 10, 2026
@github-project-automation github-project-automation bot moved this to 📋 Needs Review in Commerce - Pull Requests Feb 10, 2026
@github-project-automation github-project-automation bot moved this from 📋 Needs Review to 👍 Approved in Commerce - Pull Requests Feb 10, 2026
Removed unnecessary closing CodeBlock tags from the documentation.
Clarify product search example for Cruz Verde 2014 models.
- Fix description injection bug: decouple argument description injection
  from query description check so FIELD_ARGUMENT descriptions are applied
  independently (fetch-and-enhance-schema.js, inject-descriptions.js)
- Fix build-with-enhanced-schema.js to use the enhanced schema file
  instead of re-fetching from the live endpoint
- Consolidate DOCUMENTATION_OVERLAY_SUMMARY.md into spectaql/README.md
  and remove the redundant file
- Streamline the root README, defer SpectaQL details to spectaql/README.md
- Update build instructions to recommend enhanced build for custom
  descriptions
- Regenerate API reference with injected argument descriptions
- Add CategoryProductView type section with examples for breadcrumb rendering
  and family filtering
- Rewrite CategoryNavigationView, CategoryProductView, and CategoryTreeView
  type descriptions as scannable bullet lists
- Expand CategoryTreeView type definition with description, metaTags, and
  images fields; add metadata/images query example
- Add tree diagrams to Navigation and CategoryTree query examples
- Add CategoryViewV2 API reference links and consolidate use case scenarios
- Fix minor formatting in api-testing.md
- Update query example headings to reduce repition
- Use slots for request and response blocks to shorten code blocks
- Move products query examples to the query examples section
@meker12 meker12 added major-update Significant original updates to existing content and removed bug Something isn't working labels Feb 19, 2026
@meker12 meker12 changed the title Fix product query example Categories GraphQL storefront updates Feb 19, 2026
@meker12 meker12 merged commit 9b3fbe8 into main Feb 19, 2026
7 checks passed
@meker12 meker12 deleted the meker12-patch-3 branch February 19, 2026 17:18
@github-project-automation github-project-automation bot moved this from 👍 Approved to 🏁 Done in Commerce - Pull Requests Feb 19, 2026
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

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

3 participants