tidy some documentation

Tidy some docs as linkt to godoc