testing: structure package documentation

Makes finding the relevant information much easier.

R=golang-dev, adg
CC=golang-dev
https://codereview.appspot.com/8353045

Committer: Andrew Gerrand <adg@golang.org>