[doc] Documentation cleanup

Changes by mt, pwieczorkiewicz and kmroz.