Describe the usage of tags in the "Running"-section

pesse · pesse · commit 40badacae3f1 · 2019-10-11T17:58:54.000+02:00
Fixes #1003
diff --git a/docs/userguide/running-unit-tests.md b/docs/userguide/running-unit-tests.md
@@ -282,6 +282,23 @@ select * from table(ut.run('hr.test_apply_bonus', a_random_test_order_seed => 30
 **Note**
 >Random order seed must be a positive number within range of 1 .. 1 000 000 000. 
   
+# Run by Tags
+
+In addition to the path, you can filter the tests to be run by specifying tags. Tags are defined in the test with the `--%tags`-annotation.  
+Multiple tags are separated by comma. If multiple tags are set, all tests with __any__ of them specified are run.
+
+Example Procedure:
+```sql
+begin
+  ut.run('hr.test_apply_bonus', a_tags => 'test1,test2');
+end;
+```
+Example Function:
+```sql
+select * from table(ut.run('hr.test_apply_bonus', a_tags => 'suite1'))
+```
+
+
 # Keeping uncommitted data after test-run
 
 utPLSQL by default runs tests in autonomous transaction and performs automatic rollback to assure that tests do not impact one-another and do not have impact on the current session in your IDE.
