Update URL for documentation

[stefsmeets]

          Seems like readthedocs does not approve of updating the url: https://docs.readthedocs.io/en/stable/faq.html#how-do-i-change-my-project-slug-the-url-your-docs-are-served-at

Originally posted by @stefsmeets in https://github.com/FormingWorlds/PROTEUS/issues/121#issuecomment-2269224748

We could try to set up a new project under the new URL and use that instead. readthedocs does not support changing the url through their backend.

[timlichtenberg]

Good for me, homogenising both URLs and the look and feel of the docs is of high priority I think.

[lsoucasse]

Agreed.

[stefsmeets]

Sounds good, I will also see how we can set up subpages for the different projects we have atm (janus, mors, any others?).

[stefsmeets]

I have created a new project under the name fwl-proteus: https://fwl-proteus.readthedocs.io/en/latest/

TODO

• [x] Set up github integration
• [x] Set up subprojects
• [x] Change references in documentation -> #124
• [x] Change url in sidebar to https://fwl-proteus.readthedocs.io/

Subprojects:

• https://fwl-proteus.readthedocs.io/projects/janus/
• https://fwl-proteus.readthedocs.io/projects/mors/

[stefsmeets]

@timlichtenberg Could you give me maintainer access so that I can set up the readthedocs integration (so that it automatically builds on every push)? I don't have the permissions.

[timlichtenberg]

I used this request to unify access rights. @stefsmeets @lsoucasse @nichollsh you should have now unified "maintain" rights on all PROTEUS repositories (at the moment PROTEUS, JANUS, MORS, ZEPHYRUS, SOCRATES) through the "PROTEUS maintainer" team. Please let me know if you encounter issues

[nichollsh]

Thanks, Tim!

[stefsmeets]

Thanks @timlichtenberg! Could you check if you can give us access to webhooks?

[timlichtenberg]

Does this need admin access, and does it need to be configured for each repo or for the organisation?

[stefsmeets]

I believe so, usually it is automatic if you have the rights when you import the project on readthedocs. Feel free to have a go yourself: https://readthedocs.org/dashboard/fwl-proteus/integrations/275696/

The steps are described here: https://docs.readthedocs.io/en/latest/guides/setup/git-repo-manual.html#manual-integration-setup

[timlichtenberg]

I will not be able to do this today or potentially until next week, apologies. To not be the bottleneck, I just gave you temporary admin rights, if that's fine for you. :>

[stefsmeets]

Everything working as expected now, I'm closing this issue.