Refresh installation and build docs

[cmacdonald]

This addresses the changes discussed in #695.

[Julian-O]

• File name contains typo: buildLing.rst

[cmacdonald]

Thanks for the review @Julian-O. Feedback addressed.

[misl6]

Hi @cmacdonald !

I've left some comments. Some of them are not really tied to your PR, but makes sense to update what looks outdated, while we're moving things.

Let me know what you think about it.

[cmacdonald]

Hi @misl6. Thanks for your review. I addressed those changes.

I read over the building.rst in more details, adding my own thoughts about duplicated material and possible better structuring, and other thoughts about the material.

[cmacdonald]

Thanks @misl6. I vastly simplified the building page. Screenshot here for ease of reference:

Perhaps the Visual Studio link could be inline like the rest?

Did I remove anything important?

[Julian-O]

Quick style review of screenshot:

• Title has inconsistent capitalisation.
• Java Development Kit - make the link apply to the whole phrase, not just Java.
• Java Development Kit - add "(JDK)" to introduce the abbreviation that is used below.
• "the building requirements" -> "the build requirements"
• Gnu Compiler Collection - add a link to https://gcc.gnu.org/ - consider adding the name of the apt-get package.
• Yes, inline the Microsoft downloads link
• pip install . - I never know whether to specify that you need to download the code, and change into the directory with setup.py before running this - I mean, the sort of people who want to do this know that, right? right??
• "This installs Cython" - add a link to what Cython is
• "shell environment variable" - remove the word "shell" which is a Unix-specific term.

[cmacdonald]

Revised version:

"shell environment variable" - remove the word "shell" which is a Unix-specific term.

I currently left this, as the previous sentence talks about Python build environments.

[Julian-O]

"shell environment variable" - remove the word "shell" which is a Unix-specific term.

I currently left this, as the previous sentence talks about Python build environments.

I don't care enough to suggest a further change, but both Windows and Linux build environments have "environment variables", but only Linux (and Unix) use the term "shell" so when you talk about "shell environment variables" being needed on Windows, it doesn't match up.

[misl6]

LGTM. Thank you!

Agree with @Julian-O regarding env variables, but I also do not want to lock this PR progress. Feel free to address it separately.