kayx23 opened a new pull request, #2148: URL: https://github.com/apache/apisix-website/pull/2148
## Summary - generalize the existing Admin API Scalar publisher, renderer, styles, and tests so they also serve the APISIX Control API - render the current 3.19, archived 3.16–3.18, and Next Control API contracts from their matching `apache/apisix` sources - provide English and Chinese routes, same-origin OpenAPI downloads, and version navigation - preserve Markdown for missing, invalid, failed, timed-out, or JavaScript-disabled rendering - pin immutable merged Control API fixtures and validate every generated asset byte-for-byte The renderer remains feature-detected: 3.15 and older archives stay Markdown-only because they do not have canonical version-specific contracts. ## Source ownership | Documentation version | Canonical Control API source | | --- | --- | | 3.16 | `apache/apisix@0f0fef3304579dc495c1131f09c98d947aea9abc` | | 3.17 | `apache/apisix@36079fe60f55d88ffb27f513ac912f5b1729ff20` | | 3.18 | `apache/apisix@687d89c68f754d7192761ea55b38d276d1b85e82` | | 3.19 | `apache/apisix@8e4a79346658d93de8e5bed7f4fcbb6cf8fd4979` | | Next | `apache/apisix@6205e4a568106eea8277f61ae6ef942bbff62d97` | Both locales consume the same canonical English OpenAPI document for each version. Production synchronization does not fetch specifications from contributor forks. ## Validation - canonical source-readiness check for Admin and Control APIs on 3.16–3.18 and Next - immutable fixture parity for all five Control API contracts, including the current 3.19 Astro source - focused Node tests: 4 passed - targeted ESLint and Stylelint checks - Docusaurus production build completed for English and Chinese archives - Astro production build completed: 1,370 pages with sitemap validation - browser coverage: 40 desktop/mobile English/Chinese render and no-JavaScript cases, plus 32 fallback, loading, and 3.15 Markdown-only cases - `git diff --check` The Docusaurus build continues to report the repository's existing cross-surface broken-link inventory because the docs-only build does not include the separately built website/blog surfaces; it completes successfully with `onBrokenLinks: log`. ## Compatibility Existing Admin API behavior and routes remain unchanged. The shared renderer keeps one loading/fallback implementation for both API families and preserves the current safety settings: no hosted request execution, credential persistence, telemetry, or Scalar agent. ## Rollback Reverting this PR restores Markdown-only Control API pages while leaving the canonical specifications in `apache/apisix` unchanged. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
