fixes after review
Merge pull request #996 from bem/blocks-doc-fix

fixes after review