Reorganize the installation documents.

doc/build.rst

@@ -2,7 +2,7 @@
 Building From Source
 ####################
 
-This page gives instructions on how to build and install XGBoost from scratch on various
+This page gives instructions on how to build and install XGBoost from the source code on various
 systems.  If the instructions do not work for you, please feel free to ask questions at
 `the user forum <https://discuss.xgboost.ai>`_.
 
@@ -44,7 +44,8 @@ This section describes the procedure to build the shared library and CLI interfa
 independently.  For building language specific package, see corresponding sections in this
 document.
 
-- On Linux/OSX the target library is ``libxgboost.so``
+- On Linux and other UNIX-like systems, the target library is ``libxgboost.so``
+- On MacOS, the target library is ``libxgboost.dylib``
 - On Windows the target library is ``xgboost.dll``
 
 This shared library is used by different language bindings (with some additions depending
@@ -56,10 +57,10 @@ on the binding you choose).  The minimal building requirement is
 For a list of CMake options like GPU support, see ``#-- Options`` in CMakeLists.txt on top
 level of source tree.
 
-Building on Linux distributions
+Building on Linux and other UNIX-like systems
 ===============================
 
-On Ubuntu, after obtaining the source code, one builds XGBoost by running CMake:
+After obtaining the source code, one builds XGBoost by running CMake:
 
 .. code-block:: bash
 
@@ -69,10 +70,10 @@ On Ubuntu, after obtaining the source code, one builds XGBoost by running CMake:
   cmake ..
   make -j$(nproc)
 
-Building on OSX
+Building on MacOS
 ===============
 
-Obtain ``libomp`` from Homebrew:
+Obtain ``libomp`` from `Homebrew <https://brew.sh/>`_:
 
 .. code-block:: bash
 
@@ -447,7 +448,7 @@ You might find the exact location by running ``.libPaths()`` in R GUI or RStudio
 Building JVM Packages
 *********************
 
-Building XGBoost4J using Maven requires Maven 3 or newer, Java 7+ and CMake 3.13+ for compiling the JNI bindings.
+Building XGBoost4J using Maven requires Maven 3 or newer, Java 7+ and CMake 3.13+ for compiling Java code as well as the Java Native Interface (JNI) bindings.
 
 Before you install XGBoost4J, you need to define environment variable ``JAVA_HOME`` as your JDK directory to ensure that your compiler can find ``jni.h`` correctly, since XGBoost4J relies on JNI to implement the interaction between the JVM and native libraries.
 

doc/install.rst

@@ -6,7 +6,7 @@ XGBoost provides binary packages for some language bindings.  The binary package
 the GPU algorithm (``gpu_hist``) on machines with NVIDIA GPUs. Please note that **training
 with multiple GPUs is only supported for Linux platform**. See :doc:`gpu/index`.  Also we
 have both stable releases and nightly builds, see below for how to install them.  For
-building from source, checkout :doc:`here </build>`.
+building from source, visit :doc:`this page </build>`.
 
 .. contents:: Contents
 
@@ -16,8 +16,7 @@ Stable Release
 Python
 ------
 
-Pre-built binary are uploaded to Pypi for each release.  Supported platforms are Linux
-with x86_64, aarch, Windows x86_64 and OSX.
+Pre-built binary are uploaded to PyPI (Python Package Index) for each release.  Supported platforms are Linux (x86_64, aarch64), Windows (x86_64) and MacOS (x86_64).
 
 .. code-block:: bash
 
@@ -37,7 +36,7 @@ into permission errors.  Python pre-built binary capability for each platform:
 +-------------------+---------+----------------------+
 | Linux aarch64     | |cross| |  |cross|             |
 +-------------------+---------+----------------------+
-| OSX               | |cross| |  |cross|             |
+| MacOS             | |cross| |  |cross|             |
 +-------------------+---------+----------------------+
 | Windows           | |tick|  |  |cross|             |
 +-------------------+---------+----------------------+
@@ -69,7 +68,7 @@ R
   .. code-block:: bash
 
     # Install dependencies
-    R -q -e "install.packages(c('data.table', 'magrittr', 'jsonlite', 'remotes'))"
+    R -q -e "install.packages(c('data.table', 'magrittr', 'jsonlite'))"
     # Install XGBoost
     R CMD INSTALL ./xgboost_r_gpu_linux.tar.gz
 
@@ -129,7 +128,7 @@ Python
 ------
 
 Nightly builds are available. You can go to `this page <https://s3-us-west-2.amazonaws.com/xgboost-nightly-builds/list.html>`_,
-find the wheel with the commit id you want and install it with pip:
+find the wheel with the commit ID you want and install it with pip:
 
 .. code-block:: bash