move it to the bottom

Author: glennj

exercises/shared/.docs/tests.md

@@ -28,6 +28,35 @@ echo "some,input,here" | gawk -f some-exercise.awk
 The tests use functions from the [bats-assert][bats-assert] library.
 Help for the various `assert*` functions can be found there.
 
+## Skipped tests
+
+Solving an exercise means making all its tests pass.
+By default, only one test (the first one) is executed when you run the tests.
+This is intentional, as it allows you to focus on just making that one test pass.
+Once it passes, you can enable the next test by commenting out or removing the
+
+    [[ $BATS_RUN_SKIPPED == true ]] || skip
+
+annotations prepending other tests.
+
+## Overriding skips
+
+To run all tests, including the ones with `skip` annotations, you can run:
+```bash
+BATS_RUN_SKIPPED=true bats test-some-exercise.bats
+```
+
+It can be convenient to use a wrapper function to save on typing: in `bash` you can do:
+```bash
+bats() {
+    BATS_RUN_SKIPPED=true command bats *.bats
+}
+```
+Then run tests with just:
+```bash
+bats
+```
+
 ## Debugging output
 
 ```exercism/caution
@@ -69,40 +98,16 @@ Hiding the details in a function may improve readability if you use it in severa
 
 ```awk
 BEGIN {
-    debug("a debug message")
-    print "Hello, World!"
+    debug("starting ...")
 }
 
-function debug(msg) {print msg > "/dev/fd/3"}
-```
-
-## Skipped tests
-
-Solving an exercise means making all its tests pass.
-By default, only one test (the first one) is executed when you run the tests.
-This is intentional, as it allows you to focus on just making that one test pass.
-Once it passes, you can enable the next test by commenting out or removing the
-
-    [[ $BATS_RUN_SKIPPED == true ]] || skip
-
-annotations prepending other tests.
-
-## Overriding skips
+# do stuff here ...
 
-To run all tests, including the ones with `skip` annotations, you can run:
-```bash
-BATS_RUN_SKIPPED=true bats test-some-exercise.bats
-```
-
-It can be convenient to use a wrapper function to save on typing: in `bash` you can do:
-```bash
-bats() {
-    BATS_RUN_SKIPPED=true command bats *.bats
+END {
+    debug("... finished")
 }
-```
-Then run tests with just:
-```bash
-bats
+
+function debug(msg) {print msg > "/dev/fd/3"}
 ```
 
 [bash]: https://exercism.org/docs/tracks/bash/tests