Add interface documentation

[jupp0r]

All public interfaces need to be documented, especially regarding to memory management contracts and thread safety.

[0mp]

Any suggestions on how/where we may want to document it?

[jupp0r]

A good start would be in the headers.

[gjasny]

We now have https://jupp0r.github.io/prometheus-cpp/ which is generated from the master branch.