diff --git a/README.md b/README.md
index 8b137891..33d0726a 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,42 @@
+# Welcome to SAP Cloud Application Programming model samples
 
+Find here the samples for the openSAP course [Building Applications with the SAP Cloud Application Programming Model](https://open.sap.com/courses/cp7).
+
+## Get Access to SAP Business Application Studio
+The recommended environment for the course is SAP Business Application Studio.  Watch [unit 2 of week 1](https://open.sap.com/courses/cp7/items/51pzQUzbXHr2kdbOmVs6jI) for how to get access.
+
+## Setup
+
+In SAP Business Application Studio, open a terminal.
+Then clone the repo with this specific branch:
+
+```sh
+git clone https://github.com/sap-samples/cloud-cap-samples -b OpenSAP-week2-unit4567
+cd cloud-cap-samples
+```
+
+In the `cloud-cap-samples` folder run:
+```sh
+npm install
+```
+
+## Run
+
+Now you're ready to run the samples, for example:
+```sh
+cd packages/bookshop
+cds watch
+```
+
+After that open this link in your browser: <http://localhost:4004>
+
+
+## Get Support
+
+Check out the cap docs at https://cap.cloud.sap. <br>
+In case you find a bug or need support, please [open an issue in here](https://github.com/SAP-samples/cloud-cap-samples/issues/new).
+
+
+## License
+
+Copyright (c) 2020 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under SAP Sample Code License Agreement, except as noted otherwise in the [LICENSE](/LICENSE) file.