Created installation section

docs/index.rst

@@ -19,6 +19,13 @@ The documentation is structured as follows:
 
 .. grid:: 2
 
+  .. grid-item-card:: Installation
+
+    * :doc:`Prerequisites <install/hipCUB-prerequisites>`
+    * :doc:`Installation overview <install/hipCUB-install-overview>`
+    * :doc:`Installing on Windows <install/hipCUB-install-on-Windows>`
+    * :doc:`Installing on Linux and Windows with CMake <install/hipCUB-install-with-cmake>`
+
   .. grid-item-card:: API Reference
 
     * :ref:`data-type-support`

docs/install/hipCUB-install-on-Windows.rst

@@ -0,0 +1,31 @@
+.. meta::
+  :description: Build and install hipCUB with rmake.py
+  :keywords: install, building, hipCUB, AMD, ROCm, source code, installation script, Windows
+
+********************************************************************
+Building and installing hipCUB on Windows
+********************************************************************
+
+You can use ``rmake.py`` to build and install hipCUB on Windows. You can also use `CMake <./hipCUB-install-with-cmake.html>`_ if you want more build and installation options. 
+
+``rmake.py`` is located in the ``hipCUB`` root directory. To build and install hipCUB with ``rmake.py``, run:
+
+.. code:: shell
+
+    python rmake.py -i
+
+This command also downloads `rocPRIM <https://rocm.docs.amd.com/projects/rocPRIM/en/latest/index.html>`_ and installs it in ``C:\hipSDK``.
+
+The ``-c`` option builds all clients, including the unit tests:
+
+.. code:: shell
+
+    python rmake.py -c
+
+To see a complete list of ``rmake.py`` options, run:
+
+.. code-block:: shell
+
+    python rmake.py --help
+
+

docs/install/hipCUB-install-overview.rst

@@ -0,0 +1,23 @@
+.. meta::
+  :description: hipCUB installation overview 
+  :keywords: install, hipCUB, AMD, ROCm, installation, overview, general
+
+*********************************
+hipCUB installation overview 
+*********************************
+
+The hipCUB source code is available from the `hipCUB GitHub Repository <https://github.com/ROCmSoftwarePlatform/hipCUB>`_. 
+
+The develop branch is the default branch. The develop branch is intended for users who want to preview new features or contribute to the hipCUB code base.
+
+If you don't intend to contribute to the hipCUB code base and won't be previewing features, use a branch that matches the version of ROCm installed on your system.
+
+hipCUB can be built and installed with |rmake|_ on Windows, or `CMake <./hipCUB-install-with-cmake.html>`_ on both Windows and Linux.
+
+.. |install| replace:: ``install``
+.. _install: ./rocThrust-install-script.html
+
+.. |rmake| replace:: ``rmake.py`` 
+.. _rmake: ./hipCUB-install-on-Windows.html
+
+CMake provides the most flexibility in building and installing hipCUB.

docs/install/hipCUB-install-with-cmake.rst

@@ -0,0 +1,56 @@
+.. meta::
+  :description: Build and install hipCUB with CMake
+  :keywords: install, building, hipCUB, AMD, ROCm, source code, cmake
+
+.. _install-with-cmake:
+
+********************************************************************
+Building and installing hipCUB with CMake
+********************************************************************
+
+You can build and install hipCUB with CMake on AMD and NVIDIA GPUs on Windows or Linux.
+
+Before you begin, set ``CXX`` to ``amdclang++`` or ``hipcc`` if you're building hipCUB on an AMD GPU, or to ``nvcc`` if you're building hipCUB on an NVIDIA GPU. Then set ``CMAKE_CXX_COMPILER`` to the compiler's absolute path. For example: 
+
+.. code:: shell
+
+    CXX=amdclang++
+    CMAKE_CXX_COMPILER=/opt/rocm/bin/amdclang++
+
+Create the ``build`` directory inside the ``hipCUB`` directory, then change directory to the ``build`` directory:
+
+.. code:: shell
+
+    mkdir build
+    cd build
+
+Generate the makefile using the ``cmake`` command: 
+
+.. code:: shell
+
+    cmake ../. [-D<OPTION1=VALUE1> [-D<OPTION2=VALUE2>] ...]
+
+The available build options are:
+
+
+* ``BUILD_BENCHMARK``. Set this to ``ON`` to build benchmark tests. Off by default.
+* ``BUILD_TEST``. Set this to ``ON`` to build tests. Off by default. 
+* ``DEPENDENCIES_FORCE_DOWNLOAD``. Set this to ``ON`` to download the dependencies regardless of whether or not they are already installed. Off by default.
+
+Build hipCUB using the generated make file:
+
+.. code:: shell
+
+    make -j4
+
+After you've built hipCUB, you can optionally generate tar, zip, and deb packages:
+
+.. code:: shell
+
+    make package
+
+Finally, install hipCUB:
+
+.. code:: shell
+
+    make install

docs/install/hipCUB-prerequisites.rst

@@ -0,0 +1,34 @@
+.. meta:: 
+  :description: hipCUB Installation Prerequisites
+  :keywords: install, hipCUB, AMD, ROCm, prerequisites, dependencies, requirements
+
+********************************************************************
+hipCUB prerequisites
+********************************************************************
+
+hipCUB has the following prerequisites on all platforms:
+
+* CMake version 3.16 or higher
+
+On AMD GPUs:
+
+* `ROCm <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/index.html>`_ 
+* `amdclang++ <https://rocm.docs.amd.com/projects/llvm-project/en/latest/index.html>`_ 
+* `rocPRIM <https://rocm.docs.amd.com/projects/rocPRIM/en/latest/index.html>`_ 
+
+amdclang++ is installed with ROCm. rocPRIM is automatically downloaded and installed by the CMake script.
+
+On NVIDIA GPUs:
+
+* The CUDA Toolkit
+* CCCL library version 2.3.2 or later
+* CUB and Thrust
+* libcu++ version 2.2.0
+
+The CCCL library is automatically downloaded and built by the CMake script. If libcu++ isn't found on the system, it will be downloaded from the CCCL repository.
+
+On Windows:
+
+* Python verion 3.6 or later
+* Visual Studio 2019 with Clang support
+* Strawberry Perl

docs/sphinx/_toc.yml.in

@@ -4,6 +4,16 @@ root: index
 subtrees:
   - entries:
     - file: what-is-hipcub
+  - caption: Installation
+    entries:
+    - file: install/hipCUB-prerequisites
+      title: Installation prerequisites
+    - file: install/hipCUB-install-overview
+      title: Installation overview
+    - file: install/hipCUB-install-on-Windows
+      title: Installing on Windows
+    - file: install/hipCUB-install-with-cmake
+      title: Installing on Linux and Windows with CMake
   - caption: API reference
     entries:
     - file: api-reference/data-type-support