Skip to content

Document GraphQL scalar pages and case-colliding URLs - #8427

Open
brandonmcconnell wants to merge 2 commits into
mainfrom
cursor/graphql-fern-urls-d639
Open

brandonmcconnell wants to merge 2 commits into
mainfrom
cursor/graphql-fern-urls-d639

Conversation

@brandonmcconnell

@brandonmcconnell brandonmcconnell commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Documentation changes

Updates api-playground/graphql-setup.mdx for two GraphQL reference changes:

  • Custom scalars get type pages and can be selected with TYPE. Code: mintlify/mint#14356 and mintlify/server#10469.
  • When two names differ only by case, the name that sorts first keeps its URL, the other gets a kebab-case URL (for example types/storefront-config-type), and the build logs a warning. All other URLs are unchanged. Code: mintlify/mint#14764 and mintlify/server#10967.

Only the English page is edited. Translations come from General Translation.

Merge this after those code PRs are live.

Screenshots

These come from a local mint dev preview of this repo. The changed text is outlined in red.

Generated pages: the Types bullet now lists custom scalars, and a new paragraph explains the URL rule for names that collide.

Before: Generated pages section

After: Generated pages section with the updated Types bullet and the new URL paragraph

Selectors: the TYPE <name> bullet now lists custom scalars.

Before: selector list

After: selector list with the updated TYPE bullet


For Reviewers

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts
  • Content follows the style guide

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Not run locally: vale, mint broken-links and mint a11y aren't installed on this VM.

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Note

Low Risk
Documentation-only change to GraphQL setup guidance; no product code or runtime behavior in this repo.

Reviewed by Cursor Bugbot for commit a288ff3. Bugbot is set up for automated code reviews on this repo. Configure here.

Co-authored-by: brandon <brandon@dreamthinkbuild.com>
@mintlify

mintlify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 12, 2026, 2:43 AM

Co-authored-by: brandon <brandon@dreamthinkbuild.com>
@cursor cursor Bot changed the title Document kebab-case GraphQL URLs and scalar type pages Document GraphQL scalar pages and case-colliding URLs Nov 12, 2026

This branch was successfully deployed

1 active deployment
staging — a288ff35 Deployed Nov 12, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants