- Notifications
You must be signed in to change notification settings - Fork 36
added more precise comments based on CodeJam in Bratislava #7
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice additions, only some very minor changes please. Thanks! Can you also re-take the second command palette screenshot so it's in context - it currently shows you working in the tutorial content. Alternatively, you could omit that screenshot and any reference to it.
exercises/01/readme.md Outdated
| ||
To be able to open VS Code from the usual 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` in VS Code or via the menu bar. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- how about on macOS?
- is "P" really upper case in "Ctrl-Shift-P"? I think the convention is to show the keys, i.e. Ctrl-Shift-p
- via the menu bar -> via menu path View -> Command Palette
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/01/readme.md Outdated
| ||
Open the `Command Palette` by pressing `Ctrl+Shift+P` in VS Code or via the menu bar. | ||
| ||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- please use better description in the [ ... ] part
- also capitalise Command Palette here (and elsewhere)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/01/readme.md Outdated
| ||
Search for `code` the command palette and execute `Install 'code' command in PATH`. | ||
| ||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- same comment as earlier - better desc and capitalisation please
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/01/readme.md Outdated
| ||
A success message for the process should then appear at the bottom right of the screen. | ||
| ||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- same comment as earlier - better desc and capitalisation please
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/02/readme.md Outdated
| ||
### 1. Initialize a new CAP project | ||
| ||
Before you start creating a new project it's highly recommended to 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). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- it's highly recommended to -> we recommend that you
- good tip, btw!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/04/readme.md Outdated
| ||
: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). | ||
| ||
 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- please capitalise appropriately even in descriptions of images (csv -> CSV) - these show up on screen readers which will know to pronounce the acronym CSV only if it's written in capitals
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
exercises/10/readme.md Outdated
| ||
### 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- please don't forget period at end of sentence
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done!
Thanks @maxstreifeneder |
No description provided.