kayx23 opened a new pull request, #2146:
URL: https://github.com/apache/apisix-website/pull/2146

   ## Summary
   
   - show `Next` in Scalar on the unreleased Admin API page instead of the 
canonical contract version
   - keep the fetched and downloadable OpenAPI document unchanged
   - preserve release-version labels for current and archived documentation
   - add unit and browser regression coverage
   
   ## Why
   
   Scalar displays `info.version` from the OpenAPI document. The canonical 
contract on `apache/apisix:master` correctly reports `3.19.0` because APISIX 
code and documentation configuration still use that version, but the website 
publishes this contract under the `next` documentation channel. Showing 
`v3.19.0` there makes the unreleased contract look identical to the 3.19 
release even though `master` contains additional operations.
   
   This PR changes only the in-memory copy passed to Scalar when the route 
version is `next`. The canonical asset and download remain byte-for-byte 
unchanged, so Apache remains the single source of truth and contract validation 
is unaffected.
   
   ## Validation
   
   - shared Admin API unit tests: 3 passed
   - ESLint on changed TypeScript and test files: passed
   - bilingual Docusaurus production build: passed
   - production-style browser verification: English and Chinese Next pages show 
`Next`
   - canonical download verification: `info.version` remains `3.19.0`
   - `git diff --check`: passed


-- 
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]

Reply via email to