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?

Reply via email to