Switchover to "current" documentation paths

[daveverwer]

Fixes #2797

⚠️ Not ready to merge ⚠️

I want several PRs to go live at the same time so I'll consolidate into thif branch with further PRs.

[daveverwer]

@finestructure even though this PR is not complete. What is here is ready for review and other changes will come from other PRs merged into this.

[daveverwer]

To be re-opened at a later time