DRAFT - DO NOT MERGE ⚠️ feat: Reintroduce multiversion docs

[cicdguy]

Reintroduces the multiversion docs feature per @manciniedoardo's request.

The change was reverted in ee3e5b1 per @pharmaverse/admiral's decision.

This PR will reintroduce multiversion docs.

See examples where this is successfully used:

• datacutr: https://pharmaverse.github.io/datacutr/main/
• teal: https://insightsengineering.github.io/teal/latest-tag/
• tern: https://insightsengineering.github.io/tern/latest-tag/
• mmrm: https://openpharma.github.io/mmrm/latest-tag/
• ... and 40+ other repos

[cicdguy]

Weird - I don't see a "draft" option for this PR, maybe because pharmaverse is a free-tier GitHub org.

[github-actions]

Package	Line Rate	Health
admiral	98%	✔
Summary	98% (5318 / 5423)	✔

[bms63]

Thanks @cicdguy!! Shall I merge this in now?

We have a new CRAN release on Jan 15 be great to work out any kinks before that

[cicdguy]

Thanks @cicdguy!! Shall I merge this in now?

We have a new CRAN release on Jan 15 be great to work out any kinks before that

Not yet - I'll need to push the past versions into the gh-pages branch. Also I'll do a full check regarding link updates across other repos as they may be referring to admiral articles whose URLs will change as a result of this.

[bms63]

Thanks @cicdguy!! Shall I merge this in now?
We have a new CRAN release on Jan 15 be great to work out any kinks before that

Not yet - I'll need to push the past versions into the gh-pages branch. Also I'll do a full check regarding link updates across other repos as they may be referring to admiral articles whose URLs will change as a result of this.

Roger! I guess that is why you wanted to set it to DRAFT! Just ping me if you want a second set of eyes or to merge in. Thanks again for making this update - I know you are in high demand!

[cicdguy]

I'll revisit this after the upcoming release. Do not want to disrupt anything that way.

[github-actions]

This Pull Request is stale because it has not been worked on in 15 days.

[bms63]

@cicdguy think we can proceed with this PR now. admiral was released on January 15th with no issues identified...so far.

[bms63]

Will the links not be an issue once this is merged into main - the ones with cran-release are all failing.

[cicdguy]

@bms63 - yes those links will all be updated. There's some other background work required to finish this end-to-end (re-provisioning older version on gh-pages etc), so I'll keep this open until that other work has also been completed.

[manciniedoardo]

Update from @cicdguy: progress on this expected by end of month