numpy/numpy-financial

DOC: How to install docs dependencies and build documentation with poetry

melissawm opened this issue · 1 comments

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.

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.