diff --git a/docs/problems.rst b/docs/problems.rst
index ba629d6..21f0139 100644
--- a/docs/problems.rst
+++ b/docs/problems.rst
@@ -44,14 +44,19 @@ way to do this, for example, using Ubuntu::
 
     sudo apt-get install libxml2 libxslt1.1 zlib1g python
 
-Then you have several options:
+Then you have several options. The following text applies for most Python
+software by the way.
 
 The dirty, easy way
 ~~~~~~~~~~~~~~~~~~~
 
 The easiest way to install vdirsyncer at this point would be to run::
 
-    pip install --user vdirsyncer
+    pip install --user --ignore-installed vdirsyncer
+
+- ``--user`` is to install without root rights (into your home directory)
+- ``--ignore-installed`` is to work around Debian's potentially broken packages
+  (see :ref:`debian-urllib3`).
 
 This method has a major flaw though: Pip doesn't keep track of the files it
 installs. Vdirsyncer's files would be located somewhere in
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index e83be29..f699cef 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -18,7 +18,8 @@ your distribution:
 - `GNU Guix <https://www.gnu.org/software/guix/package-list.html#vdirsyncer>`_
 - `homebrew <http://braumeister.org/formula/vdirsyncer>`_
 - `Gentoo <https://packages.gentoo.org/packages/dev-python/vdirsyncer>`_
-- Debian and Ubuntu don't have packages, but make a manual installation
+- `Debian Sid <https://packages.debian.org/search?keywords=vdirsyncer&searchon=names&exact=1&suite=all&section=all>`_.
+- Debian stable and Ubuntu don't have packages, but make a manual installation
   especially hard. See :ref:`debian-urllib3`.
 
 If there is no package for your distribution, you'll need to :ref:`install