python / psf-salt

PSF infrastructure configuration
MIT License
108 stars 56 forks source link

Docs: Make previewing in development easier #364

Open JacobCoffee opened 5 days ago

JacobCoffee commented 5 days ago

When needing to work on docs, I find the following a little cumbersome

psf-salt$ cd docs
psf-salt/docs$ make html && python -m http.server

It would be nice to have

ewdurbin commented 5 days ago

I agree that some online option would be a benefit.

As a note, docs can be built with the tox target tox -e docs

hugovk commented 4 days ago

sphinx-autobuild is very handy, we have a make htmllive using it for the devguide, CPython docs and PEPs repos. For example:

https://github.com/python/devguide/blob/main/Makefile