Merge branch 'occstatus' of https://github.com/adamliyi/docs-1
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.