Repository: teemtee/tmt (language: python)

Issue:
Add a new `Test Runner` section to the guide
Let users know which collections are available on the test runner.

Pull Request Checklist

* [x] update the specification


Discussion / hints:
An old docs todo item. Blocked on Testing Farm having the docs published. Or are we ok with pointing directly to git?
I’m not sure we should add TF-motivated caveats and notes into tmt metadata specification. It’s basically spoiling the information space with info good for a single special user of tmt. In other words, if - when… - MS picks tmt for their CI system, will we amend tmt specification to include pecularities of that system as well?

What would you say of we had a page dedicated to “Running tmt in TF”, collecting this kind of information? BTW, this is exactly the sort of info I would look for on TF website - what tmt version, what plugins, what collections can I use, and so on. Metadata specification does not feel like a good place for hosting this info.
> What would you say of we had a page dedicated to “Running tmt in TF”, collecting this kind of information?

Yeah, makes sense. In d11db6d8 I've added a new `Testing Farm` section to the guide. @happz, @thrix, @martinhoyer, what do you think?
Documentation-only PR, merging.

Fix patch:
diff --git a/docs/releases.rst b/docs/releases.rst
index 4cc2b52a9d..e2104265da 100644
--- a/docs/releases.rst
+++ b/docs/releases.rst
@@ -8,6 +8,11 @@
 tmt-1.38.0
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+A new :ref:`test-runner` section has been added to the tmt
+:ref:`guide`. It describes some important differences between
+running tests on a :ref:`user-system` and scheduling test jobs in
+:ref:`testing-farm`.
+
 The :ref:`/plugins/report/junit` report plugin now removes all
 invalid XML characters from the final JUnit XML.
 


Test patch:
diff --git a/docs/guide/test-runner.inc.rst b/docs/guide/test-runner.inc.rst
index 3eddf3ee10..708def4da5 100644
--- a/docs/guide/test-runner.inc.rst
+++ b/docs/guide/test-runner.inc.rst
@@ -10,6 +10,8 @@ care of the execution. This section covers some important details
 about common test runners.
 
 
+.. _user-system:
+
 User System
 ------------------------------------------------------------------
 
@@ -29,6 +31,8 @@ you trust the project before executing tests on your system. See
 also the :ref:`/stories/features/feeling-safe` section.
 
 
+.. _testing-farm:
+
 Testing Farm
 ------------------------------------------------------------------