Ensure that examples are properly explained

[msporny]

Some of the examples in the specification contain no explanation and some might benefit from an explanation of what the example is showing.