Models comments 105

Changed many comments to doc strings
Most of them obvious, but some clarity is added.