Adds explicit short getting started to docs, addresses #4.

docs/source/example.rst

@@ -1,3 +1,5 @@
+.. _example_long:
+
 Example
 ==================
 

docs/source/getting_started.rst

@@ -0,0 +1,96 @@
+Getting started
+=====================================
+
+This is the guide to quickly get going with the local motion planning benchmark suite.
+
+
+Pre-requisites
+-----------------
+
+- Linux Ubuntu LTS >= 18.04
+- Python >3.6, < 3.10
+- pip3
+- gnuplot (``sudo apt install gnuplot``)
+- [Optional] `poetry <https://python-poetry.org/docs/>`_
+- [Optional] `embotech forces pro <https://www.embotech.com/products/forcespro/overview/>`_ for mpc
+
+
+Installation
+------------
+
+You first have to download the repository
+
+.. code:: bash
+
+    git clone [email protected]:maxspahn/localPlannerBench.git
+
+Then, you can install the package using pip as:
+
+.. code:: bash
+
+    pip3 install .
+
+Optional: Installation with poetry
+------------------------------------
+
+If you want to use `poetry <https://python-poetry.org/docs/>`_, you have
+to install it first. See their webpage for instructions
+`docs <https://python-poetry.org/docs/>`_. Once poetry is installed, you can
+install the virtual environment with the following commands. Note that during 
+the first installation ``poetry update`` takes up to 300 secs.
+
+.. code:: bash
+
+    poetry update
+    poetry install
+
+The virtual environment is entered by
+
+.. code:: bash
+
+    poetry shell
+
+Tutorial
+------------
+
+The following is a very simple example case.
+
+Run an experiments:
+
+Experiments should be added in separate folder in ``experiments``. 
+One very simple example can be found in this folder.
+Note that you need to active your poetry shell if you have installed the package using
+poetry by
+
+.. code:: bash
+
+    poetry shell
+
+Then you navigate there by
+
+.. code:: bash
+
+    cd experiments/1_fabric_mpc/pointMass
+
+Then the experiment is run with the command line interface
+
+.. code:: bash
+
+    ../../../plannerbenchmark/exec/runner -c setup/exp.yaml -p fabric setup/fabric.yaml --render
+
+Postprocessing:
+
+The experiments can be postprocessed using the provide executable. When
+using poetry, make sure you are in the virtual environment (``poetry shell``)
+
+.. code:: bash
+
+    cd path/to/folder/of/experiment
+
+The you can run the post processor with arguments as
+
+.. code:: bash
+
+    ../../../plannerbenchmark/exec/postProcessor --exp path/to/experiment -k time2Goal pathLength --plot
+
+More detailed information about this example can be found in :ref:`example_long`

docs/source/index.rst

@@ -11,6 +11,7 @@ Welcome to Local Planner Bench's documentation!
    :caption: Contents:
 
    introduction
+   getting_started
    example
    structure
 

docs/source/introduction.rst

@@ -6,78 +6,3 @@ local motion planning algorithms. Running and postprocessing is
 available and we aim to offer a nice interface to implement a wrapper to
 your own motion planner.
 
-Dependencies
--------------
-
-The package generates plots using `gnuplot`. Gnuplot can be installed on ubuntu
-using aptitude.
-
-.. code:: bash
-
-   sudo apt install gnuplot
-
-
-Installation
-------------
-
-You first have to download the repository
-
-.. code:: bash
-
-    git clone [email protected]:maxspahn/localPlannerBench.git
-
-You can install the package using pip as:
-
-.. code:: bash
-
-    pip3 install .
-
-If you want to use `poetry <https://python-poetry.org/docs/>`_, you have
-to install it first. See their webpage for instructions
-https://python-poetry.org/docs/. Once poetry is installed, you can
-install the virtual environment with
-
-.. code:: bash
-
-    poetry update
-    poetry install
-
-The virtual environment is entered by
-
-.. code:: bash
-
-    poetry shell
-
-Run an experiments
-------------------
-
-Experiments should be added in separate folder in ``experiments``. Some
-default experiments are setup in this repositiory. Navigate there by
-
-.. code:: bash
-
-    poetry shell
-    cd experiments/1_fabric_mpc/pointMass
-
-Then the experiment is run with the command line interface
-
-.. code:: bash
-
-    ../../../plannerbenchmark/exec/runner -c setup/exp.yaml -p fabric setup/fabric.yaml --render
-
-Postprocessing
---------------
-
-The experiments can be postprocessed using the provide executable. When
-using poetry, make sure you are in the virtual environment.
-
-.. code:: bash
-
-    poetry shell
-    cd path/to/folder/of/experiment
-
-The you can run the post processor with arguments as
-
-.. code:: bash
-
-    ../../../plannerbenchmark/exec/postProcessor --exp path/to/experiment -k time2Goal pathLength --plot