code review iteration

* Give the OS-specific site-packages directories for NumPy's OpenBLAS.
* Include the `pip install numpy --only-binary numpy` variation, but not `:numpy:` since pip install doesn't document that. `pip install --only-binary numpy numpy` also works but that's confusing to parse.
* Drop the sentence on the Accelerate bug on macOS < 11.3 since this isn't the place for it.
  * Also drop the search-order part about Accelerate? This applies to Numpy 1.19 as well as 1.21+.
* Clarify the part about finding external BLAS/LAPACK libs.

Some doc should explain what people need to know about installation. If they need portable, reproducible results, they should probably use the same BLAS/LAPACK libs compiled with the same compiler everywhere.

It's unfortunate to install NumPy + SciPy linked to Accelerate, along with more pips, only to discover that NumPy won't load on their Mac and have to start over. Or will SciPy reject the older LAPACK API and have problems using different BLAS/LAPACK libs?

Installing pips in Docker takes over an hour (vs. 15 minutes) if linking NumPy and SciPy to an external BLAS/LAPACK (and another pip conditionally compiles from source if NumPy did).

Worse to have to debug CI failures because their CI on Linux computes different output than Accelerate.

Should this also explain how to tell which release of OpenBLAS is included in a NumPy installation? (What got us into installing NumPy from source was needing an OpenBLAS bug fix release.)

0 files changed, 0 insertions, 0 deletions