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% (5519 / 5631)	✔

[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

[github-actions]

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

[github-actions]

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

[manciniedoardo]

@cicdguy now that docs are built successfully, i guess this is almost done? 🙏

[cicdguy]

Almost ready to go. Just need to resolve an issue with Staged Dependencies for tag-based events.

[manciniedoardo]

@cicdguy how is this going?

[cicdguy]

Going good. Tests are running fine. We should be good to merge.

[manciniedoardo]

Ok I'll resolve the conflicts and merge tomorrow if no other comments!

Edit: conflicts already resolved

[manciniedoardo]

Thanks @cicdguy 😄

[cicdguy]

Ok I'll resolve the conflicts and merge tomorrow if no other comments!

Oh snap. I resolved it (I think).

[manciniedoardo]

Hmm coverage still unhappy :(

[cicdguy]

Darn, let me fix that.

[manciniedoardo]

not sure if it's you, seeing it on other PRs

[cicdguy]

Yeah it's my bad. Need to fix

[cicdguy]

Ok should be fixed now.

[bms63]

Ok should be fixed now.

okay to merge this in? we still will have dev version of site?

[cicdguy]

Yes. Exactly

[bms63]

@cicdguy thanks again!!!

[bms63]

@cicdguy any chance we can not have .9000 appear as version?

[cicdguy]

Yes, change your tag/DESCRIPTION to the correct version: https://github.com/pharmaverse/admiral/blob/v1.2.0/DESCRIPTION#L4

v1.2.0 has 1.2.0.9000 in the DESCRIPTION file :)

[bms63]

ah darn that is on me then. ummm..

[bms63]

alright fixed up

[bundfussr]

alright fixed up

@bms63 , I think there went something wrong. The older versions were removed and the cran-release folder was removed from the gh-pages branch. This causes the link checker to fail (see https://github.com/pharmaverse/admiral/actions/runs/15443291847/job/43466150660?pr=2754).

[bms63]

@cicdguy could we get some pointers? I just modified the tag-v1.2.0 and then did a re-release on the updated tag.

[bms63]

[cicdguy]

Ouch. Yeah that's bad. I'll look into it next week or so.