update DOC blocks spacing, add some missing documentation
Merge pull request #1252 from patrickkettner/docs-updates

update DOC blocks spacing, add some missing documentation