Merge pull request #7 from maxstreifeneder/master

added more precise comments based on CodeJam in Bratislava

Author: qmacro

exercises/01/command-palette.png

@@ -81,6 +81,16 @@ When successfully installed, you should see the extension thus:
 
 ![CDS Language Support extension installed in VS Code](vscode-extension.png)
 
+To be able to open VS Code from the OS command line you need to add the installation path of VS Code to the environment variable PATH. There's an option to do this via the `Command Palette` in VS Code. 
+
+Open the `Command Palette` by pressing `Ctrl-Shift-P` (Windows) or ⇧⌘P (macOS) in VS Code. You can also open it via the menu bar: View -> Command Palette.
+
+![Command Palette navigation in the menu bar](command-palette.png)
+
+A success message for the process should then appear at the bottom right of the screen. 
+
+![message that the 'code' command was successfully installed](sucessfully-installed.png)
+
 ### 3. Verify your development environment
 
 :point_right: Run the following command from the terminal to check whether all required tools are installed.

exercises/01/install-code-path.png

@@ -14,6 +14,8 @@ After completing these steps you'll be familiar with how you can use the CDS com
 
 ### 1. Initialize a new CAP project
 
+Before you start creating a new project we recommend that you create a dedicated directory for this CodeJam within your users directory instead of any system directories (e.g. DO NOT work in C:\Windows\System32).
+
 The first thing to do in any new CAP based project is to initialize that project by indirectly creating a directory with various basic files in it. This can be achieved with the CDS command line tool `cds` which you installed in [exercise 01](../01/).
 
 The `cds` tool should be available in your executable path, having been installed as part of the Node.js `@sap/cds` package in the [previous exercise](../01/).

exercises/01/readme.md

@@ -16,6 +16,8 @@ The SAP Cloud Application Programming Model adopts a "convention over configurat
 
 :point_right: Create a `csv/` directory within the `db/` directory, and copy into it the CSV files (from this repository) [my.bookshop-Books.csv](my.bookshop-Books.csv) and [my.bookshop-Authors.csv](my.bookshop-Authors.csv). Use the "Raw" link from within each of these GitHub resources to get the actual CSV data to download (and don't forget to ensure the `.csv` extension is used for the files that you save).
 
+![raw option on the CSV pages](raw-option.png)
+
 Your directory structure should then look something like this (the screenshot also shows the content of the two CSV files):
 
 ![the CSV files in the right place](csv-files.png)

exercises/01/sucessfully-installed.png

@@ -10,7 +10,8 @@ At the end of these steps, your project will be deployed to SAP Cloud Platform C
 
 ### 1. Sign in to Cloud Foundry
 
-:point_right: Run the following command from your command line to log in to the referenced Cloud Foundry endpoint. When prompted use your SAP Cloud Platform credentials
+:point_right: Run the following command from your command line to log in to the referenced Cloud Foundry endpoint. When prompted use your SAP Cloud Platform credentials.
+
 ```
 cf login -a https://api.cf.eu10.hana.ondemand.com
 ```

exercises/02/readme.md

@@ -6,7 +6,7 @@ There are hardware and software prerequisites for participating in this CodeJam.
 
 Each participant should have their own laptop with enough admin privileges to be able to install software. You should also be able to access a command line shell (e.g. `cmd.exe` on Windows). The laptop should also be able to connect to the host organization's guest network for Internet access, and have enough power for the whole day.
 
-## Cloud Platform
+## SAP Cloud Platform
 
 Each attendee should have an SAP Cloud Platform trial account, and specifically a Cloud Foundry environment with an organization and a space defined. See the following tutorials for more details: