Re-reading BUILDING.md, it seems like this doc might be a victim of being added to iteratively over time without consideration to the overall structure. I am purposing to par down some of the language and shift the sections around in a flow that a novice quickstep user would probably want:
0 a header with TOC 1 basic building instructions 2 common flags we use for quick troubleshooting 3 List of advanced cmake flags 4 appendix of other, uncommon features - building on windows - vagrant I'll make a PR with these changes, but does anyone have an initial objection to the change in structure?