1 files changed, 38 insertions, 0 deletions
diff --git a/docs/source/install.rst b/docs/source/install.rst
new file mode 100644
index 0000000..939bdaf
--- /dev/null
+++ b/docs/source/install.rst
@@ -0,0 +1,38 @@
+Installation
+============
+
+Brutal Maze should run on Python version 3.6 and above.
+If you're using an Unix-like operating system, you're likely
+to have Python installed on your computer.  Otherwise, you can
+download it from python.org_.
+
+The game also uses multiple third-party libraries, which is recommended to
+be installed using ``pip``.  There is a detailed documentation about getting
+this package manager on pypa.io_.
+
+Install from PyPI
+-----------------
+
+For convenience reasons, every release of Brutal Maze is uploaded to the Python
+Package Index.  To either install or upgrade, open your terminal (on Windows:
+Command Prompt or PowerShell) and run::
+
+   pip install --user --upgrade brutalmaze
+
+This requires the `the user scheme`_ scripts directory to be
+in your environmental variable ``$PATH``.
+
+Install from Source
+-------------------
+
+If you want to tweak the game or contribute, clone the git repository::
+
+   git clone https://git.disroot.org/McSinyx/brutalmaze.git
+
+Then install it using ``pip``, like so::
+
+   pip install --user brutalmaze/
+
+.. _python.org: https://www.python.org/downloads/
+.. _pypa.io: https://pip.pypa.io/en/latest/installing/
+.. _the user scheme: https://docs.python.org/3/install/index.html#alternate-installation-the-user-scheme