some notes added to models and controllers