From 6c24411f854f8095b468c94cbff908dd55a5288c Mon Sep 17 00:00:00 2001
From: Petr Šplíchal <psplicha@redhat.com>
Date: Oct 07 2019 10:12:40 +0000
Subject: Add a preparation section to the tests page


This should make it a bit more for cases like:
https://pagure.io/fedora-ci/general/issue/20

---

diff --git a/modules/ROOT/pages/tests.adoc b/modules/ROOT/pages/tests.adoc
index 07a82de..960e4c4 100644
--- a/modules/ROOT/pages/tests.adoc
+++ b/modules/ROOT/pages/tests.adoc
@@ -279,3 +279,29 @@ See the xref:quick-start-guide.adoc#_contributing[Quick Start Guide] to get reco
 
 [[Category:FedoraAtomicCi]]
 
+
+== Preparation ==
+
+If you need to do any adjustments to the system before testing, include an extra ansible task before the testing section.
+For example this will upgrade all packages on the system to the latest version:
+
+[source,ansible]
+----
+- hosts: localhost
+  tags:
+    - classic
+  tasks:
+    - dnf:
+        name: "*"
+        state: latest
+
+- hosts: localhost
+  roles:
+  - role: standard-test-basic
+    tags:
+    - classic
+    tests:
+    - smoke38:
+        dir: smoke
+        run: VERSION=3.8 METHOD=virtualenv ./venv.sh
+----