- Create a release branch for new version of docs (can be from a personal fork too).
- Define version of the docs. This MUST be the major + minor version ONLY. For example, if the next Ratify version is
1.2.0
, then the docs version will be1.2
. - Generate new versioned documentation:
npm run docusaurus docs:version <DOC VERSION>
- Push new versioned docs and sidebars. Then, PR to main branch.
- Once a new versioned doc set is generated, the previous version is automatically marked as stale with a banner on top.
- The website will default to the latest versioned doc