documentation fixes
Merge pull request #522 from bem/docs.fixes

[WIP] вычитка документации