add notes on controllers and example