Skip to content

Why did you go to the sphinx-book-theme instead of the pydata-sphinx-theme ? #8701

Closed
@12rambau

Description

@12rambau

Is your feature request related to a problem?

Let's face it, it's not a problem per se, I really liked the new documentation and the recent logo revamp.

I think xarray is a big lib and has thus a very dense documentation (many pages, many API entries etc). This is exactly why the pydata-sphinx-theme has been designed for. Using the top navigation top bar you can facilitate reading within the documentation by reducing the burden on the primary sidebar. At first I though you went full on executable book which would require to use the sphinx-book-theme but as you are still relying on .rst files and pure sphinx, changing theme is still an option.

Was it already discussed somewhere or is the door still open for modifications ?

Describe the solution you'd like

Slightly change the documentation conf.py to rely on the pydata-sphinx-theme.

Additional context

full disclaimer, I'm a maintainer of the pydata-sphinx-theme (that lives in the very same organization).

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions