Remove wiki

CODEOWNERS

@@ -18,7 +18,7 @@ NOTICE                  @AcademySoftwareFoundation/rez-tsc
 /src/rez/data/          @AcademySoftwareFoundation/rez-tsc
 
 # Docs
-/wiki/                  @AcademySoftwareFoundation/rez-tsc
+/docs/                  @AcademySoftwareFoundation/rez-tsc
 
 # Core
 /src/rez/backport       @AcademySoftwareFoundation/rez-tsc

CONTRIBUTING.md

@@ -15,10 +15,10 @@ sending a pull request. Please follow these guidelines:
 7.  Use [this format](https://help.github.com/articles/closing-issues-using-keywords/)
     to mention the issue(s) your PR closes;
 8.  Add relevant tests to demonstrate that your changes work;
-9.  Add relevant documentation [here](wiki/pages) to document your changes, if applicable. Those
+9.  Add relevant documentation [here](docs/source) to document your changes, if applicable. Those
     markdown files prefixed with `_` are internal and should not be changed.
 10. If your changes add a new rez config setting, update [rezconfig.py](src/rez/rezconfig.py) and
-    document the setting. The comments in this file are extracted and turned into Wiki content. Pay
+    document the setting. The comments in this file are extracted and turned into documentation. Pay
     attention to the comment formatting and follow the existing style closely.
 
 ## CLA

INSTALL.md

@@ -1,89 +1 @@
-## Installation Script
-
-> [[media/icons/warning.png]] Only Python greater or eual to 3.7 is supported
-> when installing via the install script!
-
-To install rez, download the source. Then from the root directory, run:
-
-```
-]$ python ./install.py
-```
-
-This installs rez to `/opt/rez`. See `install.py -h` for how to install to a
-different location.
-
-Once the installation is complete, a message tells you how to run it:
-
-```
-SUCCESS! To activate Rez, add the following path to $PATH:
-/opt/rez/bin/rez
-
-You may also want to source the completion script (for bash):
-source /opt/rez/completion/complete.sh
-```
-
-> [[media/icons/warning.png]] Do _not_ move the installation - re-install to a new
-> location if you want to change the install path. If you want to install rez for
-> multiple operating systems, perform separate installs for each of those systems.
-
-
-## Installation Via Pip
-
-It is possible to install rez with pip, like so:
-
-```
-]$ pip install rez
-```
-
-> [[media/icons/info.png]] While the `install.py` script only supoprts Python 3,
-> rez is still usable with Python when installed via pip. In other words, the API
-> is fully compatible with Python 2 and 3.
-
-However, this comes with a caveat - rez command line tools _are not guaranteed
-to work correctly_ once inside a rez environment (ie after using the `rez-env`
-command). The reasons are given in the next section.
-
-Pip installation is adequate however, if all you require is the rez API, or you
-don't require its command line tools to be available within a resolved environment.
-
-Note that running pip-installed rez command line tools will print a warning like so:
-
-```
-Pip-based rez installation detected. Please be aware that rez command line tools
-are not guaranteed to function correctly in this case. See
-https://github.com/AcademySoftwareFoundation/rez/wiki/Installation#why-not-pip-for-production
-for futher details.
-```
-
-
-## Why Not Pip For Production?
-
-Rez is not a normal python package. Although it can successfully be installed
-using standard mechanisms such as pip, this comes with a number of caveats.
-Specifically:
-
-* When within a rez environment (ie after using the `rez-env` command), the rez
-  command line tools are not guaranteed to function correctly;
-* When within a rez environment, other packages' tools (that were also installed
-  with pip) remain visible, but are not guaranteed to work.
-
-When you enter a rez environment, the rez packages in the resolve configure
-that environment as they see fit. For example, it is not uncommon for a python
-package to append to PYTHONPATH. Environment variables such as PYTHONPATH
-affect the behaviour of tools, including rez itself, and this can cause it to
-crash or behave abnormally.
-
-When you use the `install.py` script to install rez, some extra steps are taken
-to avoid this problem. Specifically:
-
-* Rez is installed into a virtualenv so that it operates standalone;
-* The rez tools are shebanged with `python -E`, in order to protect them from
-  environment variables that affect python's behaviour;
-* The rez tools are stored in their own directory, so that other unrelated tools
-  are not visible.
-
-Due to the way standard wheel-based python installations work, it simply is not
-possible to perform these extra steps without using a custom installation script.
-Wheels do not give the opportunity to run post-installation code; neither do
-they provide functionality for specifying interpreter arguments to be added for
-any given entry point.
+See https://rez.readthedocs.io/en/stable/installation.html for installation instructions.

README.md

@@ -6,7 +6,6 @@
 [![Windows](https://github.com/AcademySoftwareFoundation/rez/workflows/windows/badge.svg?branch=main)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3AWindows+branch%3Amain)<br>
 [![Installation](https://github.com/AcademySoftwareFoundation/rez/workflows/installation/badge.svg?branch=main)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3Ainstallation+branch%3Amain)
 [![Flake8](https://github.com/AcademySoftwareFoundation/rez/workflows/flake8/badge.svg?branch=main)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3Aflake8+branch%3Amain)
-[![Wiki](https://github.com/AcademySoftwareFoundation/rez/workflows/wiki/badge.svg)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3Awiki+event%3Arelease)
 [![Pypi](https://github.com/AcademySoftwareFoundation/rez/workflows/pypi/badge.svg)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3Apypi+event%3Arelease)
 [![Benchmark](https://github.com/AcademySoftwareFoundation/rez/workflows/benchmark/badge.svg)](https://github.com/AcademySoftwareFoundation/rez/actions?query=workflow%3Abenchmark+event%3Arelease)<br>
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=AcademySoftwareFoundation_rez&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=AcademySoftwareFoundation_rez)
@@ -35,18 +34,18 @@ environments reference these existing packages. This means that configured envir
 are lightweight, and very fast to create, often taking just a few seconds to configure
 despite containing hundreds of packages.
 
-See [the wiki](https://github.com/AcademySoftwareFoundation/rez/wiki) for full documentation.
+See [the wiki](https://rez.readthedocs.io) for full documentation.
 
 <p align="center">
-<a href="https://github.com/AcademySoftwareFoundation/rez/wiki/media/other_pkg_mgr.png">
-<img src="https://github.com/AcademySoftwareFoundation/rez/wiki/media/other_pkg_mgr.png"></a>
+<a href="https://github.com/AcademySoftwareFoundation/rez/raw/main/docs/source/_static/other_pkg_mgr.png">
+<img src="https://github.com/AcademySoftwareFoundation/rez/raw/main/docs/source/_static/other_pkg_mgr.png"></a>
 <br><i>Typical package managers install packages into an environment</i>
 </p>
 
 <br>
 <p align="center">
-<a href="https://github.com/AcademySoftwareFoundation/rez/wiki/media/rez_pkg_mgr.png">
-<img src="https://github.com/AcademySoftwareFoundation/rez/wiki/media/rez_pkg_mgr.png"></a>
+<a href="https://github.com/AcademySoftwareFoundation/rez/raw/main/docs/source/_static/rez_pkg_mgr.png">
+<img src="https://github.com/AcademySoftwareFoundation/rez/raw/main/docs/source/_static/rez_pkg_mgr.png"></a>
 <br><i>Rez installs packages once, and configures environments dynamically</i>
 </p>
 
@@ -90,7 +89,7 @@ and when re-evaluated later will reconstruct the same environment once more.
 ## Examples
 
 This example places the user into a resolved shell containing the requested packages,
-using the [rez-env](https://github.com/AcademySoftwareFoundation/rez/wiki/Command-Line-Tools#rez-env) tool:
+using the [rez-env](https://rez.readthedocs.io/en/stable/commands/rez-env.html) tool:
 
     ]$ rez-env requests-2.2+ python-2.6 'pymongo-0+<2.7'