godoc: fill out the docs

[stevvooe]

A number of missing items:

• [ ] Basic type documentation
• [ ] Package level description and usage example
• [ ] Move request/response types out of main package or unexport them