update models, add comments to explain code and to guide upcoming code