add some hopefully useful comments to controllers and models