[#67048958] Improve godoc

Signed-off-by: John Tuley <jtuley@pivotallabs.com>