diff --git a/README.md b/README.md
index 9b69328..c0bae54 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
-# docs
+# OpenBMC documentation
+
+This repository contains documentation for OpenBMC as a whole. There may
+be component-specific documentation in the repository for each component.
+
+ - [cheatsheet.md](cheatsheet.md): Quick reference for some common
+   development tasks
+
+ - [contributing.md](contributing.md): Guidelines for contributing to
+   OpenBMC
+
+ - [dbus-interfaces.md](dbus-interfaces.md): Reference for APIs exposed
+   to dbus
+
+ - [kernel-development.md](kernel-development.md): Reference for common
+   kernel development tasks
+
+ - [rest-api.md](rest-api.md): Introduction to using the OpenBMC REST
+   API
diff --git a/contributing.md b/contributing.md
index a975983..08ae384 100644
--- a/contributing.md
+++ b/contributing.md
@@ -11,7 +11,7 @@
 Structure
 ---------
 
-OpenBMC has quite a module structure, consisting of small daemons with a
+OpenBMC has quite a modular structure, consisting of small daemons with a
 limited set of responsibilities. These communicate over dbus with other
 components, to implement the complete BMC system.