Recommend using `pytestmark` in testing docs
The testing documentation already recommends placing all remote tests in
a separate test module. This allows applying the `remote-data` mark to
all the test functions through the `pytestmark` global variable instead
of applying a decorator to each function separately.
@@ -84,8 +84,14 @@ the ``test_module.py`` file.
``test_module_remote.py``
-------------------------
-The remote tests are much easier. Just decorate the test class or test
-functions with ``@pytest.mark.remote_data``.
+The remote tests are much easier. The file must contain the following::
+
+ import pytest
+
+ pytestmark = pytest.mark.remote_data
+
+This ensures that the test functions in remote test module are only executed if
+the ``--remote-data`` flag is used.
``setup_package.py``
--------------------
