Improve Documentation by making it very clear using some kind of standard mechanism WHEN commands are executed: configure time, build time, post build etc.
Perhaps come up with a color scheme to use in the background fill of sections of documentation showing commands (or modes of commands) that execute at configure time vs. build, etc. It can be very very confusing, even after learning CMake fairly deeply, when things are happening. This is by far the hardest part of learning CMake (just like with C++, etc). If you don't understand the different stages, in a mixed stage language like C++ or cmake, then it's next to impossible to use the system correctly.
This one change would have drastically improved my comprehension time.
Thanks for listening.