document controller usage

This might be worth elaborating...