diff --git a/README.rst b/README.rst
index 1f33660..8cfde89 100644
--- a/README.rst
+++ b/README.rst
@@ -6,6 +6,13 @@ This repository provides configuration for the `kayobe
 <https://github.com/stackhpc/kayobe>`_ project. It is intended to encourage
 version control of site configuration.
 
-See the `kayobe documentation
-<https://github.com/stackhpc/kayobe/tree/master/doc/source>`_ for further
-information on configuring kayobe.
+Kayobe is an open source tool for automating deployment of Scientific OpenStack
+onto a set of bare metal servers.  Kayobe is composed of Ansible playbooks, a
+python module, and makes heavy use of the OpenStack kolla project.  Kayobe aims
+to complement the kolla-ansible project, providing an opinionated yet highly
+configurable OpenStack deployment and automation of many operational
+procedures.
+
+* Documentation: https://github.com/stackhpc/kayobe/tree/master/doc
+* Source: https://github.com/stackhpc/kayobe
+* Bugs: https://github.com/stackhpc/kayobe/issues