Our documentation and test scripts configure using cmake and then use the native build system to compile. E.g. libmongoc's installation documentation has this for Unix:
And this for Windows:
Using cmake for the build instructions may simplify this a bit, changing both build instructions to:
In addition, if we take this approach we may be able to consolidate some of compile-unix.sh, compile-windows.sh, and compile-windows-mingw.bat.
Documenting this as the way to build may also prevent users from accidentally mixing release/debug runtimes in their application, as there have been several related bug reports:
CXX-1961, CDRIVER-3558, CXX-1780
This ticket is associated with the documentation update.