diff --git a/README b/README
deleted file mode 100644
index 09d1f1c58..000000000
--- a/README
+++ /dev/null
@@ -1,12 +0,0 @@
-This repository contains resource agents (RAs) compliant
-with the Open Cluster Framework (OCF) specification.
-
-These resource agents are used by two cluster resource
-management implementations:
-
-- Pacemaker
-- rgmanager
-
-More information about OCF resource agents is available
-in the OCF Resource Agent Developer's guide, in the
-doc/dev-guides subdirectory.
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..47d0fb583
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Resource agents
+
+This repository contains resource agents (RAs) compliant
+with the Open Cluster Framework (OCF) specification.
+
+These resource agents are used by two cluster resource
+management implementations:
+
+- Pacemaker
+- rgmanager
+
+More information about OCF resource agents is available
+in the OCF Resource Agent Developer's guide (link below).
+
+
+## Where can I find more information?
+
+* [ClusterLabs website](http://www.clusterlabs.org/)
+* [OCF Resource Agent Developer's guide](https://github.com/ClusterLabs/resource-agents/blob/master/doc/dev-guides/ra-dev-guide.asc)
+* Mailing lists for [users](http://oss.clusterlabs.org/mailman/listinfo/users) and [developers](http://oss.clusterlabs.org/mailman/listinfo/developers)
+* #clusterlabs IRC channel on [freenode](http://freenode.net/)