changeset 8688:7982eac0703d

docs: drop documentation for installing without virtualenv Installing globally as root require an unjustified trust in our build/install process ... and makes it very hard to uninstall or clean up. Installing as a user is slightly better but also more error-prone and not recommended. Those who really want to do it and know how to do it also don't need this description.
author Mads Kiilerich <mads@kiilerich.com>
date Thu, 03 Sep 2020 15:05:44 +0200
parents 5e46f73f0d1c
children 19d93bd709bf
files docs/installation.rst
diffstat 1 files changed, 6 insertions(+), 27 deletions(-) [+]
line wrap: on
line diff
--- a/docs/installation.rst	Mon Oct 12 11:12:37 2020 +0200
+++ b/docs/installation.rst	Thu Sep 03 15:05:44 2020 +0200
@@ -19,12 +19,12 @@
   installations side by side or remove it entirely by just removing the
   virtualenv directory) and does not require root privileges.
 
-- :ref:`installation-without-virtualenv`: The alternative method of installing
-  a Kallithea release is using standard pip. The package will be installed in
-  the same location as all other Python packages you have ever installed. As a
-  result, removing it is not as straightforward as with a virtualenv, as you'd
-  have to remove its dependencies manually and make sure that they are not
-  needed by other packages.
+- Kallithea can also be installed with plain pip - globally or with ``--user``
+  or similar. The package will be installed in the same location as all other
+  Python packages you have ever installed. As a result, removing it is not as
+  straightforward as with a virtualenv, as you'd have to remove its
+  dependencies manually and make sure that they are not needed by other
+  packages. We recommend using virtualenv.
 
 Regardless of the installation method you may need to make sure you have
 appropriate development packages installed, as installation of some of the
@@ -125,27 +125,6 @@
 
 You can now proceed to :ref:`install-front-end`.
 
-.. _installation-without-virtualenv:
-
-
-Installing a released version without virtualenv
-------------------------------------------------
-
-For installation without virtualenv, 'just' use::
-
-    pip install kallithea
-
-Note that this method requires root privileges and will install packages
-globally without using the system's package manager.
-
-To install as a regular user in ``~/.local``, you can use::
-
-    pip install --user kallithea
-
-You can now proceed to :ref:`install-front-end`.
-
-.. _install-front-end:
-
 
 Prepare front-end files
 -----------------------