Migrate OpenMS documentation to github pages or readthedocs.

[JKVISION1101]

Hi,

I have been assigned the task mentioned above.

First, I would like to know how to download the Doxygen and documentation files stored in abibuilder.

Second, I would appreciate any tips or precautions necessary for the process of migrating the documentation.

[matteopilz]

@jpfeuffer, do you have an idea?

[jpfeuffer]

• create sphinx folder in docs
• add conf.py for sphinx
• follow https://stackoverflow.com/questions/36064976/using-doxygen-in-read-the-docs
• change doxygen command to our cmake docs command
• deploy on read the docs with appropriate settings (environment.yml with cmake doxygen etc, correct paths, add tags to build from)
• pray to some deity that it does not timeout (tutorials etc or anything that requires compiling is most likely out of scope anyway)

[jpfeuffer]

Maybe you can avoid building if you download GitHub artifacts but I think it might be hard to do that reliably.

If you need to download docs from abibuilder IMO you don't gain anything. It will still be dependent on abibuilder.