Address package level comments for readability.

It seems the idiomatic way to do this is to create a new file called `doc.go` that has nothing but the package comment and the package statement.  That way it is obvious which file contains the package comment.