Make 'technical documentation' example intro better

This adds an example of the expected output and sets clearer
expectations about what we'd like to see there.
Merge pull request #59 from alphagov/flesh-out-general-technical-section-example

Make 'technical documentation' example intro better