This (CMake) story is currently documented here. The eventual plan is to incorporate that material into this documentation, but we haven't done it yet so this section NEEDS DOCUMENTATION.