improve go docs at the top level
part of #79