di.rst, grammer and readibility improvements