Apply suggested review changes

docs/troubleshooting.md

@@ -28,7 +28,32 @@ Run all tests:
 
     py.test -s --ansible-inventory=${CLUSTER_DIR}/inventory.yml --hosts='ansible://*'
 
-#### Advanced usage
+#### Known Issues
+
+- Default ssh backend for testinfra tests is `paramiko`, which doesn't work oout
+  of the box. It fails to connect to the host because the `ed25519` hostkey was
+  not verified. Therefore we need to force plain ssh:// with either
+  `connection=ssh` or `--hosts=ssh://…`
+
+### Behave tests
+
+Behave tests run in a browser and test if all the interfaces are up
+and running and correctly connected to each other. They are integrated in the
+`openappstack` CLI command suite.
+To run all behave tests, run the following command in this repository:
+
+    python -m openappstack CLUSTERNAME test
+
+In the future, this command will run all tests, but now only *behave* is
+implemented. To learn more about the `test` subcommand, run:
+
+    python -m openappstack CLUSTERNAME test --help
+
+You can also only run a behave test for a specific application, i.e.:
+
+    python -m openappstack CLUSTERNAME test --behave-tags nextcloud
+
+### Advanced usage
 
 Specify host manually:
 
@@ -51,13 +76,6 @@ or directly:
 
     FQDN='example.openappstack.net' pytest/test_certs.py
 
-#### Known Issues
-
-- Default ssh backend for testinfra tests is `paramiko`, which doesn't work oout
-  of the box. It fails to connect to the host because the `ed25519` hostkey was
-  not verified. Therefore we need to force plain ssh:// with either
-  `connection=ssh` or `--hosts=ssh://…`
-
 #### Running tests with local gitlab-runner docker executor
 
 Export the following environment variables like this:
@@ -71,20 +89,6 @@ then:
     gitlab-runner exec docker --env CI_REGISTRY_IMAGE="$CI_REGISTRY_IMAGE" --env SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY" --env COSMOS_API_TOKEN="$COSMOS_API_TOKEN" bootstrap
 
 
-## Behave tests
-
-Behave tests run in a headless browser and test if all the interfaces are up
-and running and correctly connected to each other. They are integrated in the
-`openappstack` CLI command suite.
-To run the behave tests, run the following command in this repository:
-
-    python -m openappstack CLUSTERNAME test
-
-In the future, this command will run all tests, but now only *behave* is
-implemented. To learn more about the `test` subcommand, run:
-
-    python -m openappstack CLUSTERNAME test --help
-
 
 ## Upgrading