Editing .rst files can be hard on the eyes, and it's nice to be able to see changes to the rendered HTML files in real time. This task proposes the following upgrades to the dev environment for a more user-friendly editing experience:
- Add a new port mapping (8080) to the web service in docker-compose
- Add the sphinx-autobuild extension as a dev dependency to live serve docs in the browser
- Add a serve-docs target to the Makefile
Usage:
- run make serve from the root project directory
- navigate to localhost:8080 in a browser window
- enjoy hot reloading of the docs as you edit!