Document Public CMake Interface

**Is your feature request related to a problem? Please describe.**
Our CMake related documentation is really not perfect.

**Describe the solution you'd like**
Provide some documentation. Maybe in doxygen?
`cmake/cmake.dox` maybe?

**Describe alternatives you've considered**
No idea.

**Additional context**
Don't know yet.