[Chapel Merge] Refactor Mac docs for clarity

Branch: refs/heads/master
Revision: 5826b48
Author: bradcray
Log Message:

Merge pull request #16327 from bradcray/mac-doc-refactor

Refactor Mac docs for clarity

[reviewed by @e-kayrakli]

As a result in some confusion expressed in issue #16269, I’ve taken
a pass over the Mac documentation to try to clarify it. I’ve also made
changes to the install-mac.html webpage in a separate effort to
avoid sending people to the Quickstart instructions prematurely,
which suggest they’ll need to build from source. See
https://github.com/chapel-lang/chapel/pull/16327 for screenshots of the

I spent some time thinking about what it would take to eliminate the arguable redundancy between these two pages, but ended up keeping it because I think the right way to get rid of the redundancy would be to eliminate the install-mac.html web page and have it point directly at the Mac-specific docs; but I think that this has the downside of not having a short-and-sweet version of the installation instructions for people who don’t need much hand-holding (say, experienced Chapel + homebrew users trying it on a Mac for the first time).

Modified Files:
M doc/rst/platforms/macosx.rst

Compare: https://github.com/chapel-lang/chapel/compare/a9d411710925...5826b48056ca