tmt, tmt-run, tmt-try: add pages

pages/linux/tmt-run.md

@@ -0,0 +1,37 @@
+# tmt run
+
+> Execute tmt test steps. By default, all steps are run.
+> See also: `tmt`, `tmt-try`.
+> More information: <https://tmt.readthedocs.io/en/stable/overview.html#run>.
+
+- Run all test steps for each plan:
+
+`tmt run`
+
+- Run only the discover step to show what tests would be run:
+
+`tmt run discover -v`
+
+- Run all steps, adjust the provision step options:
+
+`tmt run --all provision --how {{container}} --image {{fedora:rawhide}}`
+
+- Run only selected plans and tests:
+
+`tmt run plan --name {{/plan/name}} test --name {{/test/name}}`
+
+- Show results from the last run in a web browser:
+
+`tmt run --last report --how {{html}} --open`
+
+- Run tests with the provided context:
+
+`tmt run --context {{key=value}} -c {{distro=fedora}}`
+
+- Run tests interactively (debug test code in the middle of a test):
+
+`tmt run --all execute --how {{tmt}} --interactive`
+
+- Use dry mode to see what actions would happen and use highest verbosity:
+
+`tmt run --dry -vvv`

pages/linux/tmt-try.md

@@ -0,0 +1,37 @@
+# tmt try
+
+> Quickly experiment with tests and environments.
+> See also: `tmt`, `tmt-run`.
+> More information: <https://tmt.readthedocs.io/en/stable/stories/cli.html#try>.
+
+- Quickly experiment with the default provision method (no tests in cwd):
+
+`tmt try`
+
+- Run a test in the current working directory:
+
+`{{cd path/to/test &&}} tmt try`
+
+- Use a specific operating system:
+
+`tmt try {{fedora-41}}`
+
+- Select both custom image and provision method:
+
+`tmt try {{fedora@container}}`
+
+- Select tests with custom filter:
+
+`tmt try --test {{feature}}`
+
+- Provision guest and wait for instructions:
+
+`tmt try --ask`
+
+- Directly log into the guest without asking:
+
+`tmt try --login`
+
+- Display help:
+
+`tmt try --help`

pages/linux/tmt.md

@@ -0,0 +1,37 @@
+# tmt
+
+> Test Management Tool for creating, running and debugging tests.
+> See also: `tmt-run`, `tmt-try`.
+> More information: <https://tmt.readthedocs.io>.
+
+- Look around to see what's available:
+
+`tmt`
+
+- Initialize tmt files/project structure:
+
+`tmt init`
+
+- Create a new test with template and link:
+
+`tmt test create --template {{beakerlib}} --link {{verifies:issue#1234}}`
+
+- List available tests, plans, or stories:
+
+`tmt <test|plan|story> ls {{pattern}}`
+
+- Show detailed test metadata in the given context:
+
+`tmt --context {{arch=aarch64}} test show`
+
+- Validate tmt files against the specification:
+
+`tmt lint`
+
+- Use filter:
+
+`tmt tests ls --filter {{tag:foo}} --filter {{tier:0}}`
+
+- Display help:
+
+`tmt --help`