update DOC blocks spacing, add some missing documentation