Hi all,
so far, I had hosted the documentation on https://tenpy.github.io with github pages.
I have now tried to setup the documentation on https://tenpy.readthedocs.io as well, which is an awesome place hosting documentation for many, many python packages (and other stuff as well).
The nice thing there is that they have continuous integration, i.e. automatically update the docs after each new push to github.
Moreover, it supports keeping multiple versions of the documentation, i.e, you can still look up the doc of version 0.5.0 if a new version gets released.
They also have a different theme.
In contrast, for the github pages I had to setup an updating process myself, which is not so reliable and fast, and it can only host a single snapshot of the documentation.
Which one do you like better?
Should we update the README to link to readthedocs?
EDIT: corrected links
Readthedocs vs Github pages
Re: Readthedocs vs Github pages
Readthedocs currently includes advertisement, but we could opt-out of that.
Re: Readthedocs vs Github pages
[mention]Leon[/mention], [mention]mpsforphysics[/mention] , [mention]JakobUnfried[/mention] do you have any preferences?
Re: Readthedocs vs Github pages
This is brilliant! I much prefer readthedocs for its native updating of the docs. Also, it brings the documentation into a format that is more consistent with other python packages (in my experience). The ads are non-intrusive but I would still recommend opting out (if there are no downsides to that).
PS. the URL in your original post seems broken (links to a non-existing page on the forum, rather than the docs themselves).
PS. the URL in your original post seems broken (links to a non-existing page on the forum, rather than the docs themselves).
Re: Readthedocs vs Github pages
Okay, I paid for the Gold membership of readthedocs to remove the ads (That's the drawback, it costs money. But I don't mind supporting ReadTheDocs with a few dollars a month, their service to the community is great
)
I've also updated the references from within the TeNPy repository and the links in this forum (if they use the
Moreover, I put a big, orange warning on top of each page on tenpy.github.io to make sure people realize that the documentation moved![Very Happy :D](./images/smilies/icon_e_biggrin.gif)
![Smile :)](./images/smilies/icon_e_smile.gif)
I've also updated the references from within the TeNPy repository and the links in this forum (if they use the
[tenpy]...[/tenpy]
bbcodes) to point to the new documentation.Moreover, I put a big, orange warning on top of each page on tenpy.github.io to make sure people realize that the documentation moved
![Very Happy :D](./images/smilies/icon_e_biggrin.gif)