Revise build instructions

[ricab]

Description of documentation issue or suggestion
Our build instructions need to be revised, improved, and updated. There are multiple aspects where they are obsolete, inconsistent, or just wrong. Comments on #4110 point out a few examples.

[dmora4]

Hi @ricab
I would like to help out with this issue. I have looked over the discussion you cited (#4110) and I have gathered the examples pointed out in the comments:

• Consider the build architecture when specifying the PATH environment variable
• Consider the build architecture when specifying the path for the DCMAKE_PREFIX_PATH cmake argument
• Remove mentions of installing QT via brew
• Either keep "latest stable version" and remove the specific Qt6 version, or keep the version and remove remove reference to "latest stable version"
• Provide more context in the Enable Hyper-V section since it is not strictly required

Let me know if this issue is meant to capture only the examples cited above or if the scope of this issue involves a larger overhaul of the build instructions. Either way I am happy to help!

[ricab]

Hi @dmora4, thank you for your interest! This was meant as an umbrella to cover all problems with the build instructions, but you don't need to fix everything in one go. You could submit PRs dealing with a subset of issues and mention that it "addresses" this issue (rather than "fixes"). See https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue

Of course you can also fix it all 😄 Either way, your contributions would be very welcome!

[ayaankhan98]

@dmora4 let me know if you working on this, otherwise I can raise a PR addressing the suggested changes.

[dmora4]

@ayaankhan98 No, I haven't gotten around to it so go right ahead!