Make latest's API reference available in qibo.science

[renatomello]

Is it possible to make the docs from the main branch available in qibo.science? For instance, cupy does it. It is very inconvenient to have to either go through the code or compile the docs locally.

[alecandido]

It is certainly possible. And not even that hard.

But no one committed time recently to maintain either the workflows or the website. And some time is certainly needed to make it work properly and reliably (we already have updating issues with the current setup, that have never been investigated).

In general, on the readthedocs platform, making one more version available is just a single button push. But we are currently maintaining our own deployment, which is making it harder.
An option is certainly to get back to RTD. Which has to be coordinated with the domain management, and, occasionally, is also providing some extra burden. But the reason we moved out was even something else, which I do not even remember right now. @scarrazza?

[scarrazza]

I believe we do it already, no? https://qibo.science/qibo/latest/

[renatomello]

I believe we do it already, no? https://qibo.science/qibo/latest/

OK, thanks. I couldn't find it because there is no option in the Documentation section on the top right corner of qibo.science

[alecandido]

Ah, sorry. That's correct.

Not sure why, in my mind, I compiled the information for main into a different branch. Which is possible, but it holds what I said above: w/o RTD, it is yet another layer of complications.

[scarrazza]

I've added documentation regarding the rendering process: https://qibo.science/qibo/latest/developer-guides/contributing.html#documentation.

I intentionally kept this detail hidden from the main user interface to prevent user confusion. We still need to address the persistent caching issue with GitHub Pages upon releasing a new version.

[scarrazza]

Yes, I will include a mention to that in the devs documentation.