adding some more documentation in case I ever come back to this, and a
changelog.

Last of the changes except for a version bump and then finalized.