controller: Add controller client documentation.

Not sure all of these are detailed enough.
Replace the last sentence with

> If tail is true, new log lines are streamed after the buffered log.