Description
Currently the main geopandas.org website (the landing page, the about pages, the community page, ..) and the geopandas
package documentation are combined in a single sphinx project.
That has a few drawbacks: we want the default link for the docs to be the stable docs, but for the main website you always want the latest. In general the landing page is also quite tied to the geopandas
package, while the GeoPandas project consists of more packages. We could update that homepage, but it's also a bit strange place to do that in essentially the geopandas
documentation.
So the idea is that we could separate the main website sources from the geopandas documentation sphinx site. I think we could create a geopandas/website
repo to host those sources (or in a /web
directory in the main repo, but I think a separate repo is cleaner).
Some questions related to this that we need to answer:
- If geopandas.org now points to the main website, which url do we want to use for the documentation? I think both "docs.geopandas.org" or "geopandas.org/docs" are technically possible with readthedocs.
(and in both cases we can set up redirects for the current urls /en/stable/docs -> docs/en/stable) - For the main website, do we want to continue using sphinx? (that's of course the easiest starting from the current docs) An alternative could be to use the scientific-python hugo theme (https://github.com/scientific-python/scientific-python-hugo-theme, https://theme.scientific-python.org/)