From 9481cdcab9efd2922490dad21bb64f26d1214a76 Mon Sep 17 00:00:00 2001
From: Petr Šplíchal <psplicha@redhat.com>
Date: Mar 18 2019 13:01:56 +0000
Subject: Merge Gating Update page (#21)


---

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 399b537..74243da 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -1,6 +1,7 @@
 * xref:quick-start-guide.adoc[Quick Start Guide]
 * xref:manifesto.adoc[Manifesto]
 * xref:gating.adoc[Gating]
+* xref:gating-updates.adoc[Gating Updates]
 * xref:pipeline.adoc[Pipeline]
 * xref:standard-test-interface.adoc[Standard Test Interface]
 * xref:standard-test-roles.adoc[Standard Test Roles]
diff --git a/modules/ROOT/pages/gating-updates.adoc b/modules/ROOT/pages/gating-updates.adoc
new file mode 100644
index 0000000..f120083
--- /dev/null
+++ b/modules/ROOT/pages/gating-updates.adoc
@@ -0,0 +1,44 @@
+:toc:
+
+= Gating Updates =
+
+From Thursday January 18th 2018, bodhi has been adjusted to gate updates based on test results.
+
+Here some information about this process.
+
+== What gates? ==
+
+Currently there are three tests allowed to gate an update:
+
+* https://fedoraproject.org/wiki/Taskotron/Tasks/dist.rpmdeplint[dist.rpmdeplint] - to make sure the update's dependencies are available
+* https://fedoraproject.org/wiki/Taskotron/Tasks/dist.abicheck[dist.abicheck] - to make sure the update's ABI remains stable in stable Fedora releases
+* AtomicCI pipeline - for packages that are part of the Atomic Host *and* include in their dist-git repository tests according to xref:tests.adoc[the specifications].
+
+This last requirement only concern packages that are in Fedora Atomic Host while the first two are enforced for all packages.
+
+[NOTE]
+====
+At the moment, Bodhi only queries Greenwave every 6 hours.
+If you see a message like *1 of 2 required tests not found*, with the results already shown in the *automated tests* tab, the situation will get rectified with the next Bodhi-Greenwave sync.
+====
+
+=== Package level testing ===
+
+We are currently working on building a pipeline that will support package level testing for all packages interested in adding tests to their dist-git repositories.
+
+== How to fix the tests? ==
+
+The tests are all in your hand, you can fix the `dist.depcheck` and `dist.abicheck` by adjusting the update or the build and you can fix the package level testing since the tests are stored in the dist-git repository of the package itself.
+*You have the control on the tests*.
+
+== Go through ==
+
+There are cases where one will want to go through the gating despite the tests failing.
+This is currently allowed using the `waiverdb-cli` command line tool
+
+ dnf install waiverdb-cli
+
+See more at https://fedoraproject.org/wiki/Package_update_HOWTO#Handling_feedback_from_automated_tests[Handling feedback from automated tests].
+
+We are working on integrating this into bodhi itself to make waiving test results easier.
+See more at https://github.com/fedora-infra/bodhi/pull/2095[UI for waiving test results on an update].