di.rst, grammer and readibility improvements

Some changes to grammar and readability of di.rst