DOC: developer docs for building documentation

[K-Meech]

Describe the issue linked to the documentation

Following the instructions in the contributing guide, I failed to build the documentation locally.

• hatch --env docs run build errored with: 'make' is not recognized as an internal or external command. I'm on a Windows computer, so I guess make isn't available by default?
• hatch --env docs run serve worked, but following the http://0.0.0.0:8000/ link returned 'This site can't be reached'

Suggested fix for documentation

• It would be good to mention that Windows users should prefer to use hatch --env docs run serve as make isn't available by default. (would be good if someone could verify this is the same for their windows setup + it's not just my computer!)
• For hatch --env docs run serve, could the suggested link be changed to http://localhost:8000/? This worked on my system, and should hopefully work for mac / linux too.

[d-v-b]

this is a good argument for finding alternatives to our makefile-based docs build. I'm guessing there's a more modern way to do it that would work out of the box on windows. This would also be solved by switching to mkdocs (#3118)

[ianhi]

Agreed that this needs to be better. If you're looking for a way to build without make either of these should work:

uv run --extra docs sphinx-build -b html docs docs/_build/html

with autorebuilding

  uv run --extra docs sphinx-autobuild docs docs/_build --host 0.0.0.0

[ianhi]

At a minimum however the documentation should be updated to mention that "make" is a required dependency of those instructions.

[K-Meech]

Thanks @ianhi ! Both of those uv options worked for me.