Fix and delegate installation instructions to documentation

Author: molinav

README.md

@@ -11,43 +11,9 @@ on PyPI and can be installed with [`pip`]:
 python -m pip install basemap
 ```
 
-Otherwise, you will need to install `basemap` from its source hosted
-on GitHub as indicated in the following steps:
-
-1. Install pre-requisite Python modules:
-   - [cython](https://github.com/cython/cython)
-   - [numpy](https://github.com/numpy/numpy)
-
-2. Download the `basemap` source code:
-   ```sh
-   git clone --depth 1 https://github.com/matplotlib/basemap.git
-   ```
-
-3. Build the [GEOS](https://github.com/libgeos/geos) library. You may
-   use the helper provided in `utils`, (please note that you need
-   [`CMake`](https://cmake.org/) and a working C compiler in advance):
-   ```sh
-   export GEOS_DIR=<your desired location>
-   python -c "import utils; utils.GeosLibrary('3.6.5').build(installdir='${GEOS_DIR}')"
-   ```
-   or you can link directly to the system library if it is already
-   installed. `GEOS_DIR` must point to the GEOS installation prefix;
-   e.g. if `libgeos_c.so` is located in `/usr/lib` and `geos_c.h` is
-   located in `/usr/include`, then you must set `GEOS_DIR` to `/usr`.
-
-4. Build and install the `basemap` binary wheel:
-   ```sh
-   python -m pip install .
-   ```
-   On Linux, if your Python was installed through a package management
-   system, make sure that you have the Python header `Python.h` required
-   to build Cython extensions (e.g. on Debian-like systems, you should
-   have the package `python-dev` installed).
-
-5. Check that the package was installed correctly by executing:
-   ```sh
-   python -c "from mpl_toolkits.basemap import Basemap"
-   ```
+For specific details on how to install `basemap` through `conda` or
+from source, please refer to the [`basemap` installation instructions]
+in the documentation.
 
 ## Requirements
 
@@ -118,6 +84,9 @@ https://pypi.org/project/basemap-data-hires
 [`OWSLib`]:
 https://pypi.org/project/OWSLib
 
+[`basemap` installation instructions]:
+https://matplotlib.org/basemap/stable/users/installation.html
+
 [MIT]:
 https://spdx.org/licenses/MIT.html
 [LGPL-2.1-only]:

doc/source/users/installation.rst

@@ -4,16 +4,15 @@ Installation
 Installing from PyPI
 --------------------
 
-Precompiled binary wheels for Windows and GNU/Linux are available in
-PyPI (architectures x86 and x64, Python 2.7 and 3.5+) and can be
-installed with `pip`_:
+Precompiled binary wheels for Windows, GNU/Linux and MacOS are available
+on PyPI and can be installed with `pip`_:
 
 .. code-block:: sh
 
    python -m pip install basemap
 
-Installing ``basemap`` will also install ``basemap-data``, containing the
-minimal data assets required by ``basemap``. If you also need the
+Installing ``basemap`` will also install ``basemap-data``, containing
+the minimal data assets required by ``basemap``. If you also need the
 high-resolution data assets, you can install them with `pip`_ too:
 
 .. code-block:: sh
@@ -24,8 +23,7 @@ Installing from conda-forge
 ---------------------------
 
 For Miniforge users, ``basemap`` packages are available through the
-``conda-forge`` channel for Windows and GNU/Linux (x64) as well as
-for MacOS (x64 and arm64):
+``conda-forge`` channel:
 
 .. code-block:: sh
 
@@ -49,13 +47,11 @@ on GitHub as indicated in the following steps:
    - `cython`_
    - `numpy`_
 
-2. Download the ``basemap`` source code and move to the
-   ``packages/basemap`` folder:
+2. Download the ``basemap`` source code:
 
    .. code-block:: sh
 
       git clone --depth 1 https://github.com/matplotlib/basemap.git
-      cd basemap/packages/basemap
 
 3. Build the `GEOS`_ library. You may use the helper provided in the
    ``utils`` folder (please note that you need `CMake`_ and a working