diff --git a/README.md b/README.md
index afb04e95..923f43d9 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # cloud-cap-samples
 
-This is a monorepository for sample projects on [SAP Cloud Application Programming Model](https://cap.cloud.sap/docs/).
+This is a monorepository for sample projects on [SAP Cloud Application Programming Model](https://cap.cloud.sap).
 
 ## Description
 
@@ -21,6 +21,16 @@ The samples provided can be run in a local setup on SQLite Database.
 
 ## Download and Installation
 
+#### Install `cds` development kit
+```sh
+# sets the registry for `@sap` packages
+npm set @sap:registry=https://npm.sap.com
+
+npm install -g @sap/cds-dk
+cds  #> test-run it
+```
+Got issues?  Check out the [documentation](https://cap.cloud.sap/docs/get-started/).
+
 #### Clone and build the application
 `git clone https://github.com/SAP-samples/cloud-cap-samples samples && cd samples && npm i`
 
@@ -48,11 +58,11 @@ None
 
 ## Known Issues
 
-None 
+None
 
 ## How to obtain support
 
-In case you find a bug, or you need additional support, please open an issue [here](https://github.com/SAP-samples/cloud-cap-samples/issues/new) in GitHub.
+Check out the documentation on https://cap.cloud.sap.  In case you find a bug, or you need additional support, please open an issue [here](https://github.com/SAP-samples/cloud-cap-samples/issues/new) in GitHub.
 
 ## To-Do (upcoming changes)