diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6a28a0d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# dotnet-core-hello-world
+This is a simple dotnet application hosting helloworld page using Cloud Foundry.
+
+## Deploying to Cloud Foundry ##
+
+After installing in the 'cf' [command-line interface](http://docs.cloudfoundry.com/docs/using/managing-apps/cf/) for Cloud Foundry, targeting a Cloud Foundry instance, and logging in, the application can be pushed using these commands:
+
+    $ git clone https://github.com/cloudfoundry-samples/dotnet-core-hello-world.git
+    $ cd dotnet-core-hello-world
+    $ cf push
+    ...
+    Push successful! App is now available at http://<route_name>.cfapps.io
+    
+The provided `manifest.yml` file will be used to provide the application parameters to Cloud Foundry. A unique URL will be assigned to the application, which is shown at the end of the output from 'cf push'.