Too much for one commit; mostly documentation
Too much for one commit; mostly documentation

Also add some new functions to improve public API, still not perfect though

whampson/bft-spec,whampson/cascara