Fix Readthedocs

[VeckoTheGecko]

Fixes #1288

Deployment on my fork is visible here: https://veckoparcels.readthedocs.io/en/patch-rtd/

[erikvansebille]

Thanks for this PR, @VeckoTheGecko. Your idea to automatically link through readthedocs.io is a good one! I forgot that we had a place for parcels there in the past...

One question; does the .readthedocs.yaml file need to be in the project root? Is there no way to put it in the docs folder and point the readthedocs server there? That would keep the project file tree a bit cleaner

[VeckoTheGecko]

I had the same thought, but unfortunately it has to be in the project root.

[erikvansebille]

OK, is this ready to be merged now?

[VeckoTheGecko]

Good to go!

I'm not sure if additional config needs to be done on your end (as the owner for the parcels project on RTD). Happy to wait and see post-merge

[VeckoTheGecko]

Looks like the official deployment isn't updating. I've updated my fork to master and that deployment is good.

It would be good to check the config/builds on RTD.

[erikvansebille]

I manually triggered the build, so the pages seem to now be updated. I'll have to check how to auto-build (via a hook?)

[erikvansebille]

Hmm, and I now also see that the left side panel (with the table of content etc) doesn't work at https://parcels.readthedocs.io/en/latest/#. Did you do anything special to get that working on your fork, @VeckoTheGecko?

[VeckoTheGecko]

Strange. Are there any errors visible in the build logs?

I didn't do any additional configuration on my side outside of this PR.

I don't have hooks/automation rules, though I do have an integration (which I think was added by default on setup). Perhaps that could be it?

[erikvansebille]

I haven't changed anything, but the disbar seems to work now. So all good after all. I just also updated the links on oceanparcels.org, to link directly to https://parcels.readthedocs.io/

[VeckoTheGecko]

Super minor detail, but might be worth disabling prior versions listed in the image as the deployment is broken on those tags.

I don't think its worth merging this branch into those tags, but just to disable those builds in RTD and use the tags for versions moving forward.

[erikvansebille]

I don't think its worth merging this branch into those tags, but just to disable those builds in RTD and use the tags for versions moving forward.

Good point, I now removed all these older versions for which the RTD integration was not working yet