Minor improvements to spec file documentation
Minor improvements to spec file documentation

The example in the spec file section now uses a fully promise-oriented
approach to show different authoring "styles" for tests.

joshfire/angela,joshfire/angela