You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We currently use sphinx-versioning to create the documentation for the different versions of pyramid_oereb as part of the CI. This package is not maintained anymore and works only with older versions of Sphinx (see e.g. this issue), so it would be nice to find an alternative.
The text was updated successfully, but these errors were encountered:
Unfortunately there does not seem to be a good alternative to sphinx-versioning (see e.g. the discussion here).
Currently, we use Sphinx to build the documentation, sphinx-versioning to create a multi-version documentation, and GitHub pages for the hosting. If we wanted to keep the documentation in multiple versions, it seems we should either migrate from Sphinx (to something like MKDocs) which requires some work (the input .rst files have to be adapted) or find another hosting solution than GitHub (like Read The Docs, which is not entirely free (advertisement or subscription), plus it would probably be a good thing to keep the project entirely at the same place, that is GitHub).
So for the moment I will remove sphinx-versioning from the CI, so that we can keep Sphinx up-to-date, but it means the documentation will only be available for the master branch. Any suggestions are of course welcome
We currently use sphinx-versioning to create the documentation for the different versions of pyramid_oereb as part of the CI. This package is not maintained anymore and works only with older versions of Sphinx (see e.g. this issue), so it would be nice to find an alternative.
The text was updated successfully, but these errors were encountered: