headers number fixed + minor corrections
Merge pull request #592 from bem/doc-fix

headers number fixed + minor corrections
Proofreading bem-tools docs
fixes according to BEMINFO-620 issue
fixes according to comments