Improve package documentation.

Move package documentation to doc.go
Show use of the Error type.