Improve docs

[guygrigsby]

The go docs are pretty sparse. They need to be reviewed and improved to include more specifics on what functions do and any side effects. Also, we make a number of references to byte slices and those should probably be made more clear by using packet.Packet.