[doc] Added a 'quickstart' tutorial

It illustrates to use of 'morse create' and friends.

Partially fix morse-simulator#396

Author: Séverin Lemaignan

doc/media/initial_sim.jpg

@@ -0,0 +1,75 @@
+MORSE quickstart
+================
+
+Creating your first simulation with MORSE is easy.
+
+First, the boring part:
+
+- :doc:`Install MORSE<user/installation>`
+- Open a terminal and check everything is well configured
+
+::
+
+ $ morse check
+
+Then, the funny part::
+
+ $ morse create mysim
+ $ morse run mysim
+
+This should be enough to launch MORSE and display a sample simulation. You can
+already control the robot with the arrow keys and check collisions with
+surrounding objects. Press :kbd:`h` to display the list of keyboard shortcuts.
+
+.. image:: ../media/initial_sim.jpg
+  :align: center
+
+So, what happened here?
+
+`morse create mysim` actually created a new subfolder in the current directory.
+
+If you inspect it, you will find a Python file called `default.py` and two
+folders. `default.py` is what we call a **Builder script** (because it uses MORSE's :doc:`Builder API<user/builder>`) and it describes your simulation.
+
+.. note::
+  Note that the script is still Python: besides the Builder API, you can use any
+  standard Python constructs to program your simulation.
+
+Open `default.py` in your favorite text editor. There are plenty of comments and
+it should be mostly self-explanatory: it builds a simulation with one robot,
+called *Morsy*, two actuators (including the keyboard for debugging/testing),
+one sensor, and these simulated components talk to the outside world via a
+socket.
+
+By checking the :doc:`component library<components_library>`, you get a first
+glimpse on what standard robots, actuators and sensors are available *out of
+the box*. You can add new elements to your simulation by directly editing
+`default.py`.
+
+.. note::
+  All simulations in MORSE are (by default) self-contained. This means that you
+  can share your simulation folder (zipping it, sharing with GIT, etc.) with
+  others, they can import it with `morse import <path>` (only required the
+  first time), and then run it exactly as you did. Convenient to work on a shared
+  project.
+
+What if you want to create a custom robot or a custom actuator/sensor?
+
+::
+
+ $ morse add robot MyCustomRobot mysim
+
+This will create a template for your robot. Open the robot description as
+hinted on the output. You will see that by default, your custom robot has the
+same two actuators and sensor as in `default.py`. You can change them to build
+a robot that match your need.
+
+Check as well `morse add actuator` and `morse add sensor` if you need to create
+custom actuators/sensors.
+
+That's all folks! You now know the basics of MORSE. Head to the
+:doc:`tutorials` section to learn how to interact with your simulated robots
+and for more advanced examples.
+
+
+

doc/morse/quickstart.rst

@@ -9,6 +9,10 @@ may require some time to master.
 However, you should hopefully be able to get very quickly your first
 simulation running.
 
+If you did not check it, we recommend you to first go over the
+:doc:`Quickstart<quickstart>` page and come back here afterwards.
+
+
 What is the general workflow?
 -----------------------------
 

doc/morse/tutorials.rst

@@ -1,7 +1,10 @@
 Build your simulations
 ======================
 
-For a quick list of builder module methods, see the
+If you did not check it, we recommend you to first go over the
+:doc:`Quickstart<../quickstart>` page.
+
+For a practical reference of the Builder API module methods, see the
 :doc:`Builder Overview<builder_overview>`.
 
 The Builder API
@@ -298,4 +301,4 @@ To modify the data of a component, just add the following line to
 your builder script::
 
 	pose.alter('Noise', pos_std=0.3)
- 
+ 

doc/morse/user/builder.rst

@@ -60,9 +60,10 @@ See their associated documentation for details.
 
 
 If you plan to use the simulator with raw sockets or text files as interface
-(for instance, to integrate MORSE with MatLab or other specific
-applications), you don't need anything else. Otherwise, you need to install
-the software for the desired middlewares:
+(for instance, to integrate MORSE with MatLab or other specific applications),
+you don't need anything else, and you can jump to MORSE's
+:doc:`Quickstart<../quickstart>`. Otherwise, you need to install the software
+for the desired middlewares:
 
 .. toctree::
     :glob:
@@ -205,6 +206,9 @@ You can check your configuration is ok with::
     $ cd build
     $ make install
 
+Time to jump to MORSE's :doc:`Quickstart<../quickstart>` tutorial!
+
+
 Installation troubleshooting
 ----------------------------