Rewriting all of the documentation is an iterative process. This is a bulk-piece of that process having at least a once-over on every file in this library. Future modifications will stem from this body of work. Any regressions caused by changes in this merge will need to be handled separately.