Updated documentation.

README.rst

@@ -22,14 +22,6 @@ goal, edi leverages top-notch open source technologies:
 
 ----
 
-
-Getting Started
-+++++++++++++++
-
-See chapter `getting started`_.
-
-.. _getting started:  docs/getting_started.rst
-
 License
 +++++++
 
@@ -46,16 +38,9 @@ Warning
 edi is still a very young project and therefore interfaces might change quickly and without notice.
 
 
-Documentation
-+++++++++++++
-
-Please check here if you need additional documentation:
-
-- `Getting started`_
-- `Command cheat sheet`_
-- `Reference list`_
+More Information
+++++++++++++++++
 
-.. _Getting started: docs/getting_started.rst
-.. _Command cheat sheet: docs/command_cheat_sheet.rst
-.. _Reference list: docs/reference_list.rst
+For more information please visit `http://www.get-edi.io`_.
 
+.. _`http://www.get-edi.io`: http://www.get-edi.io

docs/getting_started.rst

@@ -6,12 +6,6 @@ The following setup steps have been tested on Ubuntu 16.04.
 Prerequisites
 +++++++++++++
 
-#. Install various packages that are required for the development of this project:
-
-   ::
-
-     sudo apt install git-buildpackage python3-setuptools python3-setuptools-scm python3-sphinx python3-argcomplete python3-pytest python3-pytest-cov pep8 python3-pip python3-gnupg python3-yaml lxd debootstrap debhelper python3-requests-mock
-
 #. Install Ansible with a version >= 2.1. On Ubuntu 16.04 you have to enable xenial-backports and then install Ansible as follows:
 
    ::
@@ -27,9 +21,38 @@ Prerequisites
    The default settings are ok.
    Use the storage backend "dir" if there is no zfs setup on your computer.
 
+Install edi from the PPA
+++++++++++++++++++++++++
+
+For your convenience, you can directly install edi from a ppa:
+
+#. Add the `edi-snapshots`_ ppa to your Ubuntu installation:
+
+   ::
+
+     sudo add-apt-repository ppa:m-luescher/edi-snapshots
+     sudo apt-get update
+
+#. Install edi:
+
+   ::
+
+     sudo apt install edi
+
+.. _`edi-snapshots`: https://launchpad.net/~m-luescher/+archive/ubuntu/edi-snapshots
+
+
 Working with the edi Source Code
 ++++++++++++++++++++++++++++++++
 
+Hint: You can skip this section if you just want to use edi without having a look at the source code.
+
+#. Install various packages that are required for the development of this project:
+
+   ::
+
+     sudo apt install git-buildpackage python3-setuptools python3-setuptools-scm python3-sphinx python3-argcomplete python3-pytest python3-pytest-cov pep8 python3-pip python3-gnupg python3-yaml lxd debootstrap debhelper python3-requests-mock
+
 #. Clone the source code:
 
    ::
@@ -54,6 +77,10 @@ Working with the edi Source Code
 
      source local_setup
 
+
+Build a First Example
++++++++++++++++++++++
+
 #. Clone the edi-examples repository:
 
    ::

docs/index.rst

@@ -11,14 +11,8 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   introduction
    getting_started
    reference_list
    command_cheat_sheet
 
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-

docs/introduction.rst

@@ -0,0 +1 @@
+../README.rst