Fleshed out comments in `pop_models.mcmc` module
Added a significant number of comments to the pop_models.mcmc
module, which is the heart of this repo.
This is a remake of !6 (merged), which was accidentally targeted at 'master' and not 'ligo-review'.