Fix typos and add description

Author: mads-hartmann

test/README.md

@@ -60,7 +60,7 @@ If you want to run an entire test suite, the easiest is to use `./test/run.sh`:
 ./test/run.sh webapp
 ```
 
-If you're iterating on a single test, the easiest is to use `go test` directy. If your integration tests depends on having having a user token avaialble, then you'll have to set USER_TOKEN manually (see run.sh on how to fetch the credentials that are used during our build)
+If you're iterating on a single test, the easiest is to use `go test` directly. If your integration tests depends on having having a user token available, then you'll have to set USER_TOKEN manually (see run.sh on how to fetch the credentials that are used during our build)
 
 ```sh
 cd test
@@ -73,7 +73,7 @@ go test -v ./... \
     -gitlab=<true|false>
 ```
 
-A concrete exmaple would be
+A concrete example would be
 
 ```sh
 cd test

test/run.sh

@@ -1,5 +1,7 @@
 #!/usr/bin/env bash
 #
+# Convenience script to run our integration tests suites.
+#
 # Usage:
 #
 #   run.sh [suite]