Some clarification and markdown for boelle notes
Merge pull request #1230 from thinkyhead/readme_tweak

Clarification and markdown for boelle notes