Skip to content

COMDOX-1733: paginate GraphQL API reference for all schema versions#584

Merged
dshevtsov merged 13 commits into
mainfrom
ds_comdox-1733
Jun 24, 2026
Merged

COMDOX-1733: paginate GraphQL API reference for all schema versions#584
dshevtsov merged 13 commits into
mainfrom
ds_comdox-1733

Conversation

@dshevtsov

@dshevtsov dshevtsov commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Purpose of this pull request

Paginate the Commerce GraphQL API reference so each schema version loads in smaller, navigable pages instead of a single ~950 KB topic. This fixes rendering and navigation issues on developer.adobe.com while keeping SpectaQL-generated content in sync.

  • Reference pagination: Split queries, mutations, and types into separate pages for SaaS, 2.4.9 (latest), 2.4.8, 2.4.7, and 2.4.6. Types are grouped into six alphabetical ranges (A–B, C–E, F–I, K–P, Q–S, T–Z).
  • URL change (breaking): Move the default 2.4.9 reference from /reference/graphql/ to /reference/graphql/latest/. Remove the old monolithic reference/graphql/index.md topic.
  • Navigation: Add sub-page entries in config.md for each paginated reference section.
  • Cross-links: Update GraphQL schema guide topics and the reference landing page to point at the new /reference/graphql/latest/ and per-section paths (for example mutations.md, types-a-b.md).
  • Build tooling: Update generate-spectaql-md.js to emit letter-range type chunks and reference wrapper pages; sanitize SpectaQL Markdown (collapse excess blank lines, strip trailing whitespace).
  • Content fixes: Correct IEEE 754 links in Float scalar descriptions across schema JSON and generated type pages.

Affected pages

Representative published topics (full reference set spans SaaS, latest, 2.4.8, 2.4.7, and 2.4.6):

Note: External deep links to the former 2.4.9 path (/commerce/webapi/reference/graphql/) will 404 unless redirects are added separately.

Additional information

  • Add major-update label
  • Request redirect for /commerce/webapi/reference/graphql/
  • Update cross-links to the new reference paths in other Commerce Docs

Preview

https://developer-stage.adobe.com/commerce/webapi/

Tracking

Internal: COMDOX-1733
Closes #581

What's New highlights

whatsnew
The GraphQL API reference is now split into paginated topics for faster loading and easier navigation. Updated the following documentation:

  • Restructured the 2.4.9 GraphQL API reference into separate queries, mutations, and alphabetical type pages.
  • Applied the same pagination pattern to SaaS, 2.4.8, 2.4.7, and 2.4.6 reference topics.
  • Updated GraphQL schema guide cross-links to the new reference paths.

…hunks

Replace byte-sized chunkByH3 splitting with fixed alphabetical type ranges (a-b through t-z).
Write separate reference pages (queries, mutations, types-*) with one Fragment each instead of stacking all chunks on index.md.
Point the default 2.4.9 output at src/pages/reference/graphql/latest/.
Split each schema version into queries, mutations, and six alphabetical type pages so no single page embeds the full ~950 KB reference.
Move the default 2.4.9 reference from /reference/graphql/ to /reference/graphql/latest/.
Add sub-page navigation in config.md for SaaS, latest (2.4.9), 2.4.8, 2.4.7, and 2.4.6.
Update schema guide cross-links to the new latest path.

BREAKING CHANGE: 2.4.9 GraphQL API reference URLs move from /reference/graphql/ to /reference/graphql/latest/ (for example /reference/graphql/index.md → /reference/graphql/latest/index.md). External deep links to the old path will 404 unless redirects are added.
@dshevtsov dshevtsov self-assigned this Jun 22, 2026
@dshevtsov dshevtsov closed this Jun 22, 2026
@dshevtsov dshevtsov reopened this Jun 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-22T21:37:44.263Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 310

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

  ⚠️  WARNING
    Location: Line 5:7
    Message: Unexpected redirecting URL `https://developer.adobe.com/commerce/docs`, expected final URL `https://developer.adobe.com/commerce/docs/`
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-f-i.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 185:1
    Message: Unexpected redirecting URL `http://en.wikipedia.org/wiki/IEEE_floating_point`, expected final URL `https://en.wikipedia.org/wiki/IEEE_floating_point`
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-f-i.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 203:1
    Message: Unexpected redirecting URL `http://en.wikipedia.org/wiki/IEEE_floating_point`, expected final URL `https://en.wikipedia.org/wiki/IEEE_floating_point`
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-f-i.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 203:1
    Message: Unexpected redirecting URL `http://en.wikipedia.org/wiki/IEEE_floating_point`, expected final URL `https://en.wikipedia.org/wiki/IEEE_floating_point`
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-f-i.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 257:1
    Message: Unexpected redirecting URL `http://en.wikipedia.org/wiki/IEEE_floating_point`, expected final URL `https://en.wikipedia.org/wiki/IEEE_floating_point`
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    310
  📄 Files with issues:  5
  ❌ Total errors:       9
  ⚠️  Total warnings:     6
  📋 Total issues:       15

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-23T18:14:02.641Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 311

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Location: Line 14:211
    Message: Cannot find file `reference/2-4-8/index.md`. In EDS, a trailing slash (e.g., "./subdir/") resolves to "subdir/index.md", while no trailing slash (e.g., "./page") resolves to "page.md".
    Rule: missing-file

  ❌ ERROR
    Location: Line 16:3
    Message: Cannot find file `reference/saas/index.md`. In EDS, a trailing slash (e.g., "./subdir/") resolves to "subdir/index.md", while no trailing slash (e.g., "./page") resolves to "page.md".
    Rule: missing-file

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    311
  📄 Files with issues:  2
  ❌ Total errors:       11
  ⚠️  Total warnings:     1
  📋 Total issues:       12

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-23T19:21:54.886Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 311

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Location: Line 14:211
    Message: Cannot find file `reference/2-4-8/index.md`. In EDS, a trailing slash (e.g., "./subdir/") resolves to "subdir/index.md", while no trailing slash (e.g., "./page") resolves to "page.md".
    Rule: missing-file

  ❌ ERROR
    Location: Line 16:3
    Message: Cannot find file `reference/saas/index.md`. In EDS, a trailing slash (e.g., "./subdir/") resolves to "subdir/index.md", while no trailing slash (e.g., "./page") resolves to "page.md".
    Rule: missing-file

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    311
  📄 Files with issues:  2
  ❌ Total errors:       11
  ⚠️  Total warnings:     1
  📋 Total issues:       12

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-23T19:41:08.145Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 341

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    341
  📄 Files with issues:  1
  ❌ Total errors:       9
  ⚠️  Total warnings:     1
  📋 Total issues:       10

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-23T19:45:24.836Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 341

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    341
  📄 Files with issues:  1
  ❌ Total errors:       9
  ⚠️  Total warnings:     1
  📋 Total issues:       10

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@dshevtsov dshevtsov added the major-update Significant updates to content label Jun 23, 2026
@dshevtsov dshevtsov requested a review from keharper June 23, 2026 20:48
@dshevtsov dshevtsov marked this pull request as ready for review June 23, 2026 20:49
@dshevtsov dshevtsov changed the title docs(reference)!: paginate GraphQL API reference for all schema versions COMDOX-1733: paginate GraphQL API reference for all schema versions Jun 23, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-23T20:50:58.548Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 341

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    341
  📄 Files with issues:  1
  ❌ Total errors:       9
  ⚠️  Total warnings:     1
  📋 Total issues:       10

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

Comment thread src/pages/graphql/schema/b2b/company/queries/company.md Outdated
Comment thread src/pages/graphql/schema/b2b/company/unions/structure-entity.md
Comment thread src/pages/graphql/schema/b2b/negotiable-quote/interfaces/index.md
Comment thread src/pages/graphql/schema/b2b/negotiable-quote/queries/quote.md Outdated
Comment thread src/pages/graphql/schema/cart/queries/cart.md Outdated
Comment thread src/pages/graphql/schema/attributes/queries/custom-attribute-metadata.md Outdated
Comment thread src/pages/graphql/schema/customer/queries/downloadable-products.md Outdated
Comment thread src/pages/graphql/schema/customer/queries/orders.md Outdated
Comment thread src/pages/graphql/schema/store/queries/dynamic-blocks.md Outdated
Comment thread src/pages/graphql/schema/wishlist/queries/wishlist.md Outdated
…after GraphQL docs restructuring" and fix the GraphQL references

This reverts commit 04a7d05.
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-24T20:49:25.653Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 341

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    341
  📄 Files with issues:  1
  ❌ Total errors:       9
  ⚠️  Total warnings:     1
  📋 Total issues:       10

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Linter Report

Click to expand full report
═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-06-24T21:14:05.739Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 341

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-6-types-3.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-7-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-8-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-2-4-9-types-4.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/includes/autogenerated/graphql-api-saas-types-2.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/includes/autogenerated/graphql-api-saas-types-2.md'

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/reference/graphql/index.md
───────────────────────────────────────────────────────────────
  ❌ ERROR
    Message: Failed to process file - ENOENT: no such file or directory, open '/home/runner/work/commerce-webapi/commerce-webapi/src/pages/reference/graphql/index.md'


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    341
  📄 Files with issues:  1
  ❌ Total errors:       9
  ⚠️  Total warnings:     1
  📋 Total issues:       10

Result: ❌ FAILED - Fatal errors found

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

@dshevtsov dshevtsov enabled auto-merge (squash) June 24, 2026 21:57
@dshevtsov dshevtsov disabled auto-merge June 24, 2026 22:00
@dshevtsov dshevtsov merged commit 8042bbf into main Jun 24, 2026
26 of 28 checks passed
@dshevtsov dshevtsov deleted the ds_comdox-1733 branch June 24, 2026 22:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feedback maintenance major-update Significant updates to content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

GraphQL reference pages contain too much data

2 participants