docs restructured. grammar and syntax fixes