make comment changes for more informative godoc