documentation update

Making it bit easier to read and understand