Improvements to documentation

1. added HTML markup of the page displayed in examples
2. added initial BEM documentation in README
3. added initial annotation description