viiccwen opened a new pull request, #1427:
URL: https://github.com/apache/mahout/pull/1427

   ### Related Issues
   
   Closes #1355
   
   ### Changes
   
   - [ ] Bug fix
   - [x] New feature
   - [ ] Refactoring
   - [x] Documentation
   - [ ] Test
   - [ ] CI/CD pipeline
   - [ ] Other
   
   ### Why
   
   The existing Docusaurus versioning command snapshots whatever is currently 
present under `website/docs/`. Generated Python API reference pages are 
produced by the website sync step, so release managers need a deterministic 
local command that syncs generated API docs before creating a version snapshot 
and validates the result before any tag-triggered automation is considered.
   
   ### How
   
   - Replaced the website `version` npm script with a local wrapper script.
   - The wrapper keeps the existing command shape: `npm run version -- 
<release-version>`.
   - The command now runs docs sync, creates the Docusaurus docs version, then 
runs the production website build for local validation.
   - Documented the updated local versioning behavior in `website/README.md`.
   
   This does not add tag-triggered automation, deploy behavior, or CI commits 
of generated versioned docs.
   
   ## Checklist
   
   - [x] Added or updated unit tests for all changes (not applicable: website 
script/docs change; verified with local command checks)
   - [x] Added or updated documentation for all changes
   
   Verification:
   
   - `node --check website/scripts/version-docs.js`
   - `git diff --check upstream/main..HEAD`
   - `npm run version` (verifies required-version usage error)
   - `npm run version -- 1355-local-check` (temporary generated version removed 
after verification)
   


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