diff --git a/webapp/README.md b/webapp/README.md
index b692b3d9c..def0b739e 100644
--- a/webapp/README.md
+++ b/webapp/README.md
@@ -68,20 +68,20 @@ You can then visit the Storybook playground on `http://localhost:3002`
 
 {% tab title="Without Docker" %}
 
-After starting the application following the above guidelines, open new terminal windows for each of these commands:
+After starting the application following the above guidelines, open new terminal windows and navigate to the `/webapp` directory for each of these commands:
 
 ```bash
-# run eslint
+# run eslint in /webapp
 $ yarn lint
 ```
 
 ```bash
-# run unit tests
+# run unit tests in /webapp
 $ yarn test
 ```
 
 ```bash
-# start storybook
+# start storybook in /webapp
 $ yarn storybook
 ```
 
diff --git a/webapp/vue.md b/webapp/vue.md
index 47d0620f0..5116bd713 100644
--- a/webapp/vue.md
+++ b/webapp/vue.md
@@ -15,9 +15,9 @@ Placed in the same folder are also:
 
 ## We use typed props
 
-Vue.js allows us to define component props either as strings or as objects with `type`, `default` and `required` values. Always go for the second option!
+Vue.js allows us to define component props either as strings or as objects (with `type` and `default` or `required` values). Always go for the second option!
 
-Also: define defaults _only and always_ for non-required props.
+Also: only (and always!) define a `default` for props that are _not required_.
 
 Why?
 - it makes our code more robust – a warning will be shown when passing a wrong prop type