making pkg docs clearer
fixing golint errors