README improved.  More verbosity on example page and some changes on bradocs.js's comments.