Reference sections

[keharper]

Purpose of this pull request

Adds or uncomments missing ## Reference sections across several B2B mutations/queries (company address management, requisition list sharing) and the new selectFreeGiftForCart mutation, so every schema page links to the SaaS/on-prem type reference.

Affected pages

• /graphql/schema/b2b/company/mutations/assign-child-company.md
• /graphql/schema/b2b/company/mutations/unassign-child-company.md
• /graphql/schema/b2b/company/mutations/create-address.md
• /graphql/schema/b2b/company/mutations/update-address.md
• /graphql/schema/b2b/company/mutations/delete-address.md
• /graphql/schema/b2b/company/mutations/set-default-address.md
• /graphql/schema/b2b/requisition-list/mutations/share-requisition-list-by-token.md
• /graphql/schema/b2b/requisition-list/mutations/share-requisition-list-by-email.md
• /graphql/schema/b2b/requisition-list/mutations/import-shared-requisition-list.md
• /graphql/schema/b2b/requisition-list/queries/shared-requisition-list.md
• src/pages/graphql/schema/cart/mutations/select-free-gift.md

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-09-04T16:20:35.193Z
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: 11

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/schema/b2b/company/mutations/create-address.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 3:1
    Message: Description is too long (200 characters). Consider keeping it under 160 characters.
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/schema/b2b/company/mutations/delete-address.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 3:1
    Message: Description is too long (209 characters). Consider keeping it under 160 characters.
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/schema/b2b/company/mutations/set-default-address.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 3:1
    Message: Description is too long (294 characters). Consider keeping it under 160 characters.
    Rule: check-frontmatter

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/graphql/schema/b2b/company/mutations/update-address.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 3:1
    Message: Description is too long (207 characters). Consider keeping it under 160 characters.
    Rule: check-frontmatter


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

  📁 Files processed:    11
  📄 Files with issues:  4
  ❌ Total errors:       0
  ⚠️  Total warnings:     4
  📋 Total issues:       4

Result: ⚠️  PASSED WITH WARNINGS - No fatal errors

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

---

This comment was automatically generated by the linter bot.