Use the docs napari dependency groups (docs, gallery) & add to contributing guide

[psobolewskiPhD]

🧰 Task

Added in napari/napari#7487

[psobolewskiPhD]

So with those dependencies in napari/napari, it means the napari clone/install needs to use them.
And then we can drop the req.txt and that part of the Makefile?

docs/Makefile

Line 24 in 0c066aa

python -m pip install -qr $(current_dir)requirements.txt

[psobolewskiPhD]

@jni missed some requirements, so this depends on: napari/napari#7637

[psobolewskiPhD]

Once we merge:
#591
#590

I'm thinking:

• Delete requirements.txt
• remove docs-install from Makefile:

  docs/Makefile

  Lines 23 to 25 in 0c066aa

  	docs-install:
  	python -m pip install -qr $(current_dir)requirements.txt
  	python -m pip freeze

• html is standard, remove make docs because it's the same minus docs-install?

  docs/Makefile

  Lines 36 to 38 in 0c066aa

  	docs: clean docs-install docs-build
  	html: clean docs-build

• Update README and docs contribution guide to use napari[pyqt, docs]
• Update napari/napari build_docs.yml it's sort of vestigial, because it fires on merge to main and we do build/deploy from napari/docs instead. Still, can be manually triggered. Update build_docs.yml to match napari/docs napari#7640

Any thoughts @melissawm @jni ?

[melissawm]

This looks like a good plan to me. I will try to get up to speed on the recent changes and report back if I see anything missing.

[jni]

remove html and use docs minus docs-install?

I don't think we need to remove html. It will be redundant with docs but it would disrupt some workflows for little gain. In the future, we may want to support other sphinx builds such as pdf.

So maybe docs just depends on html?

Minor thing: maybe we don't include clean in the html/docs build? If one wants a clean build, they can write make clean docs, but in many situations, the build can be sped up by not cleaning?

Update napari/napari build_docs.yml it's sort of vestigial, because it fires on merge to main and we do build/deploy from napari/docs instead. Still, can be manually triggered.

I don't understand this — docs should be rebuilt when we merge to napari main?

[psobolewskiPhD]

if we remove docs-install because that's part of the napari install now, then make docs and make html become identical. Notice currently:

docs: clean docs-install docs-build 
html: clean docs-build 

make docs makes more sense to me than make html.

Docs are rebuilt on merge to main, but by the action triggered in this repo, not the napari/napari repo. So that action only really functions to be manually triggered, as an alternative to the circleCI builds on PR -- which is fine.