diff --git a/README b/README
deleted file mode 100644
index 4bf42ac..0000000
--- a/README
+++ /dev/null
@@ -1,21 +0,0 @@
-Copyright (c) 2009-2011 VMware, Inc.
-
-== What is Cloud Foundry?
- 
-Cloud Foundry is an open platform-as-a-service (PaaS). The system supports
-multiple frameworks, multiple application infrastructure services and
-deployment to multiple clouds.
-
-== What is this component
-
-The vcap-java repo contains a java client library for Cloud Foundry. 
-The library provides a set of classes that ultimately call the core
-Cloud Foundry REST API.
- 
-== License
- 
-Cloud Foundry uses the Apache 2 license.  See LICENSE for details.
-
-== Installation Notes
-
-Complete installation notes are present in the README for vcap
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0606136
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# vcap-java
+
+This repository contains Java libraries utilized by [Cloud Foundry](http://cloudfoundry.com).
+
+# What is vcap-java ?
+
+The vcap-java repo contains Java libraries that applications running on Cloud
+Foundry may utilize. Applications can include cloudfoundry-runtime library to
+easily access information about services bound to the app, its environment, as
+well as implementation of various <cloud> namespace elements. Cloud Foundry
+automatically includes the auto-reconfiguration library as needed.
+
+For more informations please see the following blogs for more details:
+
+[Cloud Foundry Services With Spring, Part 1 : The Basics](http://blog.springsource.org/2011/10/13/using-cloud-foundry-services-with-spring-part-1-the-basics/)
+
+[Cloud Foundry Services With Spring, Part 2 : Autoreconfiguration](http://blog.springsource.com/2011/11/04/using-cloud-foundry-services-with-spring-part-2-auto-reconfiguration/)
+
+[Cloud Foundry Services With Spring, Part 3 : The Cloud Namespace](http://blog.springsource.org/2011/11/09/using-cloud-foundry-services-with-spring-applications-part-3-the-cloud-namespace/)
+
+[Cloud Foundry Services With Spring, Part 4 : Spring Profiles](http://blog.springsource.org/2011/11/10/using-cloud-foundry-services-with-spring-part-4-%E2%80%93-spring-profiles/)
+
+# License
+
+Cloud Foundry uses the Apache 2.0 license. See
+[LICENSE](https://github.com/cloudfoundry/vcap-tests/LICENSE) for details.
+
+# Installation Notes
+
+Complete installation notes are present in the vcap
+[README](https://github.com/cloudfoundry/vcap-java/README).
+
+# Copyright
+
+Copyright (c) 2009-2012 VMware, Inc.