Add an updated version of the clientv2 doc to apache.

(Also make a few changes in the interfaces to match the updated doc.)

Testing Done:
n/a

Bugs closed: aurora-253

Reviewed at https://reviews.apache.org/r/18979/