Clarification and markdown for boelle notes

Hope this makes it a little clearer. Still thinking about what the "stable" branch ought to mean....