Skip to content

New GeoPandas main website (decoupled from geopandas/geopandas documentation) #17

Open
@jorisvandenbossche

Description

@jorisvandenbossche

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/)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions