Start function documentation with function name
Start function documentation with function name

As per Go convention:

> Notice this comment is a complete sentence that begins with the name
> of the element it describes. This important convention allows us to
> generate documentation in a variety of formats, from plain text to
> HTML to UNIX man pages, and makes it read better when tools truncate
> it for brevity, such as when they extract the first line or sentence.

From: http://blog.golang.org/godoc-documenting-go-code

mikepea/cdn-acceptance-tests,mikepea/cdn-acceptance-tests,alphagov/cdn-acceptance-tests,alphagov/cdn-acceptance-tests,mikepea/cdn-acceptance-tests,alphagov/cdn-acceptance-tests,mikepea/cdn-acceptance-tests,alphagov/cdn-acceptance-tests