Hey @zelig, I am afraid that I have been bailing water on the C++ client code, and ethdocs has taken a back seat post-Homestead. We should get geth team members (as well as you) engaged in this effort. I have so much on my plate.
karalabe, perhaps? He seems to be happy enough writing Wiki pages. We should get him writing RST.