From 58519093eba061080ed93200aa7913eccb439f1b Mon Sep 17 00:00:00 2001
From: Petr Šplíchal <psplicha@redhat.com>
Date: Jul 21 2020 14:37:01 +0000
Subject: The initial version of the new tmt page


Just a basic kick-off of the page with some basic content and links.

---

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 54618e5..5ed1fc0 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -8,6 +8,7 @@
 ** xref:manifesto.adoc[Manifesto]
 ** xref:standard-test-interface.adoc[Standard Test Interface]
 ** xref:standard-test-roles.adoc[Standard Test Roles]
+** xref:tmt.adoc[Test Management Tool]
 ** xref:tests.adoc[Tests]
 ** xref:pipeline.adoc[Pipeline]
 ** xref:gating.adoc[Gating]
diff --git a/modules/ROOT/pages/tmt.adoc b/modules/ROOT/pages/tmt.adoc
new file mode 100644
index 0000000..4a0666f
--- /dev/null
+++ b/modules/ROOT/pages/tmt.adoc
@@ -0,0 +1,57 @@
+:toc:
+
+= Test Management Tool =
+
+== Summary ==
+
+The `tmt` tool aims to provide an efficient and comfortable way to create, execute, debug and enable tests in the Continuous Integration.
+
+It implements the https://tmt.readthedocs.io/en/latest/spec.html[Test Metadata Specification] which allows to store all needed test execution data directly within a git repository.
+The same configuration can be used for enabling tests in the Fedora CI (near future), RHEL CI and https://packit.dev/[Packit].
+Tests can be easily executed in your preferred environment, e.g. in virtual machine, container or directly on the localhost.
+
+== Examples ==
+
+Enable basic smoke test for my component:
+
+    dnf install -y tmt
+    tmt init --template mini
+    vim plans/example.fmf
+    git add . && git commit -m tests && git push
+
+Create a new test based on a shell/beakerlib template:
+
+    tmt test create --template shell tests/basic
+    tmt test create --template beakerlib tests/advanced
+
+Run all/selected tests safely in a virtual machine:
+
+    tmt run
+    tmt run test --name smoke
+
+Execute tests in my preferred environment:
+
+    tmt run --all provision --how container
+    tmt run --all provision --how virtual
+    tmt run --all provision --how local
+    tmt run --all provision --how ...
+
+See the tmt https://tmt.readthedocs.io/en/latest/examples.html[examples] page for more inspiration.
+
+== Links ==
+
+ * https://tmt.readthedocs.io/
+ * https://packit.dev/testing-farm/
+
+== Questions ==
+
+Does the tool replace/deprecate STI?::
+    No, currently there is no plan to decommission STI.
+    Both `tmt` and `sti` approach to CI configuration can be used in parallel.
+
+Are these tests supported in Fedora CI?::
+    Fedora CI support is coming in July/August 2020.
+
+Which Linux distributions does the tool support?::
+    As a system under test (on which the tests are executed) all supported Fedora versions, Centos 6+ and Red Hat Enterprise Linux 6+ can be used.
+    For the test runner (where tmt command is run) all supported Fedora versions, Centos 8+ or Red Hat Enterprise Linux 8+ are required.