improve readme

Author: chrisweb

README.md

@@ -16,7 +16,7 @@ TODO: add screenshot here showing the "simple example" UI, explain that this is
 
 😔 there is almost no documentation yet (there is some, see next section below), to learn how to use this library I recommend you check out the source code of the [simple player example](examples/simple-player) to get started  
 
-Want to help improve the documentation or contribute to this project by improving and fixing it, then first check out the [TODOs section](#todos-help-wanted-) below, maybe there is something in the list you want to help with. Any contribution, even things not listed on the TODO list are of course welcome. To get started check out the section ["contributing" section](#contributing) below.  
+Want to help improve the documentation or contribute to this project by improving and fixing it, then first check out the [TODOs section](#todos-help--prs-appreciated) below, maybe there is something in the list you want to help with. Any contribution, even things not listed on the TODO list are of course welcome. To get started check out the section ["contributing" section](#contributing-prs-welcome) below.  
 
 ## installation
 
@@ -178,7 +178,9 @@ the current [dom.d.ts on github](https://github.com/microsoft/TypeScript/blob/ma
 
 * 4.0.0 removed UMD support, this and future versions will be ESM only
 
-## TODOs (help / PRs appreciated 😊, see the ["contributing"](#contributing-prs-welcome) section above)
+## TODOs (help / PRs appreciated)
+
+If you are interested in helping out 😊 by working on one of the following TODOs, please start by reading the ["contributing"](#contributing-prs-welcome) chapter above
 
 * create a react example
 * create a vue.js example

examples/simple-player/README.md

@@ -2,40 +2,36 @@
 
 ## build
 
-first, use your favorite command line tool and go into the root of this project:
+### tools
 
-```shell
-cd /web-audio-api-player
-```
-
-then use the follwing command in the root of this repository to build the "web-audio-api-player" itself:  
+install the latest nodejs (if you haven't already) [nodejs](https://nodejs.org)  
 
-`npm run build`
+update npm to latest version  
 
-Note: for more instructions about the web-audio-api-player itself check out the [web-audio-api-player README](../../README.md)  
+`npm install npm@latest -g`
 
-then, build the example (server & client) itself:  
+### build the player
 
-go into the example folder:  
+first, use the VSCode terminal (or your favorite command line tool) and go into the root of this project:
 
 ```shell
-cd /web-audio-api-player/examples/simple-player
+cd /YOUR_REPOSITORIES_PATH/web-audio-api-player
 ```
 
-install the latest nodejs (if you haven't already) [nodejs](https://nodejs.org)  
+then use the follwing command (in the root of this repository) to build the "web-audio-api-player" itself:  
 
-update npm to latest version  
+`npm run build`
 
-`npm install npm@latest -g`
+Note: for more instructions about the web-audio-api-player itself check out the [web-audio-api-player README](../../README.md)  
 
-install the server dependencies  
+then, build the example (server & client) itself...
 
-### client
+### example client
 
 #### go into the client folder
 
 ```shell
-cd client
+cd /examples/simple-player/client
 ```
 
 #### install the client dependencies
@@ -50,12 +46,12 @@ npm i
 npm run build
 ```
 
-### server
+### example server
 
 #### go into the server folder
 
 ```shell
-cd server
+cd /examples/simple-player/server
 ```
 
 #### install the server dependencies