Conversation
Fix markdown syntax to display the product query example for Complex products.
danidelcar
approved these changes
Feb 10, 2026
Fix markdown syntax
Fix syntax
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
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
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
CategoryProductViewtype section with examples for breadcrumb ancestor retrieval and family-based filteringCategoryTreeViewtype definition to includedescription,metaTags, andimagesfields; add query example for retrieving category details with metadata and imageschildrenSlugsCategoryView2typo toCategoryViewV2; fixcategoryTreequery signature to use required (!) typesGraphQL API reference and build tooling
README.mdto consolidate the SpectaQL build instructions into a concise quick-start section with a pointer tospectaql/README.mdfor detailsOther
api-testing.mdAffected pages
What's New highlights
whatsnew
The Implement categories on the storefront section of the Merchandising Services API Developer Guide now documents the new
CategoryProductViewtype, expandsCategoryTreeViewfield 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.