DOC: few small doc fixes to layout bugs on new website
comments added to the changes
Merge pull request #2331 from jaquesgrobler/master

DOC: few small doc fixes to layout bugs on new website