Add more detail on pytest markers

Tis PR adds a section to the developer testing docs on `pytest` markers. This supports the work in https://github.com/openmicroscopy/openmicroscopy/pull/3214

I think we have special `:envvar:` markup.