add notes on models and actions