updated models and added comments to them