Review/Improve documentation throughout repo

[jrcalgo]

Ensure that the repo's documentation is descript enough for interested/potential users (as well as other developers to understand each component/process.