fix some grammar and doc blocks