updated documentation to match godoc recommendations