Merge pull request #1480 from ldoktor/test_arg_test2

docs: Add note about args vs. positional args [v2]

docs/source/GetStartedGuide.rst

@@ -138,6 +138,13 @@ expectations, it passed! These are known as `simple tests`, but there is also an
 type of test, which we call `instrumented tests`. See more at :ref:`test-types` or just
 keep reading.
 
+.. note:: Although in most cases running ``avocado run $test1 $test3 ...` is
+          fine, it can lead to argument vs. test name clashes. The safest
+          way to execute tests is ``avocado run --$argument1 --$argument2
+          -- $test1 $test2``. Everything after `--` will be considered
+          positional arguments, therefore test names (in case of
+          ``avocado run``)
+
 Listing tests
 -------------