Add controller documentation (first version)

I have no idea why there is this section. I'm pretty sure you have a good reason, but can you please write a small paragraph and states it's deprecated?