DOC: How to install docs dependencies and build documentation with poetry
melissawm opened this issue · 1 comments
melissawm commented
Issue with current documentation:
There's no details on installing the documentation dependencies such as sphinx and the pydata-sphinx-theme in the development docs.
Idea or request for content:
Add page describing how to build the docs locally.
Kai-Striega commented
I've been holding off on writing this due to some complications in the interaction with Poetry and the current makefile we have set up.
Poetry has the concept of a dependency group. This means we can install the doc
group with poetry install --with docs
. However the makefile is still set to run with pip. The makefile should be edited to work with Poetry before we document how to set up the docs.