Updated with notes and description of changes

I still need to go through and document the logic, added descriptors
within the model.