Fix documentation versions

[graeme-a-stewart]

At the moment we don't have versioned documentation correctly produced - we only get the main branch, i.e., dev documentation.

@Moelf pointed to Lux.jl as an example that has managed to get this correct - it's probably a minor configuration issue.

However, documentation for older releases may need to be created by hand.

[graeme-a-stewart]

I am having real issues with Vitepress in that it seems to be impossible to get a working preview of the site. The suggestions in https://luxdl.github.io/DocumenterVitepress.jl/v0.1.3/getting_started#Preview-Documentation-Development-Instantly are complicated, require changes to be done, then undone and, worst of all, they didn't even work for me.

So for now I have removed the DocumenterVitepress setup via #80.

[Moelf]

locally? well you can always do that and add VitePress later

[graeme-a-stewart]

Which is a pain when certain things aren't working... I want to get the versioning sorted, then return to reenabling the fancy stuff

[graeme-a-stewart]

It is actually really important to have a good local preview when working on documentation improvements

[Moelf]

I have it working locally, but i remember it was a bit pain to set up

[graeme-a-stewart]

Yeah, too fiddly for today ;)

I have now fixed the documentation and recreated manually all of the past versions in the gh-pages branch. But I will keep this issue open until the next tag is made to check that Documenter.jl does the right thing with the next version.

[graeme-a-stewart]

Creating the next tag, v0.4.2 did not result in a documenter run. I can't see anything wrong with the GH action, which is set to run on tag events (and looks just like many of the other actions in repositories with Documenter.jl).

JetReconstruction.jl/.github/workflows/Documentation.yml

Lines 3 to 8 in 9bbd8b8

	on:
	push:
	branches:
	- main
	tags: '*'
	pull_request:

Either the document action is not being triggered, or it's triggered and is failing.

[Moelf]

I'm pretty sure you need

DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}

ref: https://documenter.juliadocs.org/stable/man/hosting/#GitHub-Actions

[graeme-a-stewart]

I also noticed that late last night! 🤞 it solves the issue.

28d7f0d

[Moelf]

I don't see we have added DOCUMENTER_KEY