This PR isn't designed to be merged: I felt it was a more helpful to comment inline on the documentation source code than to bombard you with a slew of modest issues.
With above commits, I think all these issue are addressed, short of one or two points that will no longer be required once I have added an algorithm overview to the docs.
This PR isn't designed to be merged: I felt it was a more helpful to comment inline on the documentation source code than to bombard you with a slew of modest issues.