Add documentation of make_napari_viewer and DynamicPlugin

[Czaki]

🧰 Task

When preparing a response to napari/napari#5810 I found that We do not have documentation for arguments of the make_napari_viewer fixture factory and napari_plugin_manager fixture.

It should be added to Testing section of documentation https://napari.org/stable/developers/testing.html

[lucyleeow]

The make_napari_viewer fixture has a decent docstring (recent improvements have been added). I think copying the info from the docs to the documentation would be useful. In our docs we do mention make_napari_viewer but a lot of useful information from the docstring is not included.

I could just copy it across but to ease future maintenance, maybe we could do something more clever, some kind of include or whatever is happening with the plugins contribution docs?

[lucyleeow]

I think napari_plugin_manager is now outdated but we should document the DynamicPlugin fixture, related issue see: #321 (comment)

[jaimergp]

napari_plugin_manager the name here is also confusing given how napari/napari-plugin-manager uses that as the Python package name. By "outdated", is there a change you mean "marked for deprecation"? 😬

[lucyleeow]

Yes very confusing.

By "outdated", is there a change you mean "marked for deprecation"? 😬

Yes, napari_plugin_manager is a testing fixture for npe1 plugin manager. Hopefully one day npe1 will be deprecated.... 😬

[lucyleeow]

@psobolewskiPhD could we amend the title: napari_plugin_manager -> DynamicPlugin (I don't have rights)
Note you can get the npe2 pm via DynamicPlugin.plugin_manager.

[psobolewskiPhD]

@lucyleeow Did I do it correctly?

[lucyleeow]

Yes thank you! 🙏