How to improve your docs?

Hi all,

How to improve your docs? It is simple: please add good descriptions and examples how to use a given thing. I mean the C++ docs, of course.