From c9917aac2b8230303852e3af01e7c8bc965a0467 Mon Sep 17 00:00:00 2001
From: Petr Šplíchal <psplicha@redhat.com>
Date: Nov 15 2017 16:01:55 +0000
Subject: Improve the readme file with useful links


---

diff --git a/README.md b/README.md
index 599026e..6c87d7c 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,40 @@
+
 Fedora Atomic CI
 ================
 
-This is the project to keep track of efforts and progress on the implementation
-and work on the [Fedora Atomic Host CI
-pipeline](http://fedoraproject.org/wiki/CI).
+This is the project to keep track of efforts and progress of the
+work on the Fedora Atomic Host CI.
+
+
+Documentation
+-------------
+
+To get the overall idea of the Fedora CI project see the CI portal:
+
+ * http://fedoraproject.org/wiki/CI
+
+We are using Standard Test Interface and Standard Test Roles to
+run tests in the CI pipeline:
+
+ * https://fedoraproject.org/wiki/Changes/InvokingTests
+ * https://pagure.io/standard-test-roles/
+
+For detailed instructions how to execute CI tests in all currently
+supported environments (classic, container, atomic) and current
+status of test coverage visit the following pages:
+
+ * http://fedoraproject.org/wiki/CI/Tests
+ * http://fedoraproject.org/wiki/CI/Tests/stat
+
+
+Contacts
+--------
+
+If you have questions, suggestions or issues contact us on IRC,
+mailing list or create a [new issue](https://pagure.io/fedora-ci/AtomicCi/new_issue).
+
+ * IRC channel: `#fedora-ci` on FreeNode
+ * Mailing list: `ci@lists.fedoraproject.org` and [archive](https://lists.fedoraproject.org/archives/list/ci@lists.fedoraproject.org/)
+ * Issues: https://pagure.io/fedora-ci/AtomicCi/issues
+
+