Skip to content

COMOPT-2142: Document default alphabetical ordering for searchCategory results#343

Merged
meker12 merged 4 commits into
mainfrom
COMOPT-2142-alphabetized-search-category-results
May 26, 2026
Merged

COMOPT-2142: Document default alphabetical ordering for searchCategory results#343
meker12 merged 4 commits into
mainfrom
COMOPT-2142-alphabetized-search-category-results

Conversation

@meker12
Copy link
Copy Markdown
Contributor

@meker12 meker12 commented May 26, 2026

Purpose of this pull request

Documents default alphabetical ordering for searchCategory results and regenerates the Merchandising GraphQL API reference.

  • Categories storefront guide: Adds a searchCategory result ordering section, cross-links it from usage guidance and query behavior, and updates the search-by-name example (searchTerm: "food") to show A–Z ordering (for example, Food before Food - Baby Food).
  • SpectaQL metadata: Marks payByLinkOrder and sharedRequisitionList (and related Pay By Link / shared requisition types) as undocumented so they are not included in the Merchandising API reference for v2.
  • Generated reference: Regenerates merchandising-api.md to reflect metadata filtering and the current live schema.

JIRA: COMOPT-2142

Affected pages

What's New highlights

whatsnew
Updated Implement categories on the storefront to document that searchCategory returns matching categories sorted alphabetically by name (case-insensitive), with updated examples for storefront search and picker workflows.

Alphabetized search category results
- Update metadata-merchandising.json to filter out
paybylinkorder and sharedRequisitionList since they
are not included in the Merchandising Services queries.
@meker12 meker12 self-assigned this May 26, 2026
@meker12 meker12 added enhancement New feature or request technical Changes to code, examples, or technical processes labels May 26, 2026
@github-project-automation github-project-automation Bot moved this to 📋 Needs Review in Commerce - Pull Requests May 26, 2026
Co-authored-by: Margaret Eker <meker@adobe.com>
Copy link
Copy Markdown
Contributor

@erikmarr erikmarr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a minor suggestion.

@github-project-automation github-project-automation Bot moved this from 📋 Needs Review to 👍 Approved in Commerce - Pull Requests May 26, 2026
Co-authored-by: Erik Marr <45772211+erikmarr@users.noreply.github.com>
@meker12 meker12 merged commit 1d05b61 into main May 26, 2026
8 checks passed
@meker12 meker12 deleted the COMOPT-2142-alphabetized-search-category-results branch May 26, 2026 17:53
@github-project-automation github-project-automation Bot moved this from 👍 Approved to 🏁 Done in Commerce - Pull Requests May 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request technical Changes to code, examples, or technical processes

Projects

Status: 🏁 Done

Development

Successfully merging this pull request may close these issues.

3 participants