Complete guide

doc/quickstart/qfield_quickstart.rst

@@ -39,32 +39,93 @@ Close the screen by clicking on the arrow button on the top left.
 Open a project
 ==============
 
-Can we reuse an existing / pre-installed .qgs project? where from?
+You can open any QGIS project with QField.
+
+#. Click the `Open local file` button
+#. Open the `qgis-examples` folder
+#. Click the `QGIS-Itasca-Example.qgz` project file to open the project
+
+    .. image:: /images/projects/qfield/02_open_project.png
+      :scale: 70 %
+      :alt: Choose the Itasca project to open
 
 Navigation
 ==========
 
-- pan by holding n dragging
-- zooming with mouse wheel
-- rotating by holding middle click down
-- mention touch interaction
+You can navigate on the map by
+
+#. Pan: hold and drag the mouse cursor or by moving your finger on a touch screen
+#. Zoom: with the mouse wheel or with the zoom buttons. On a touch screen it is also possible to use pinch gestures
+#. Rotate: by holding the middle mouse button down or by rotating on the screen with two fingers on a touch screen
+
+Please keep in mind that the interaction design for QField was always done with touch screens in mind
+and is therefore best served on a touch screen.
 
 Basic canvas interaction
 ========================
 
-ie feature identification
+You can identify features by clicking on them.
+In the itasca project, there are multiple layers identifiable, so you will get results from multiple layers, in this case here "airports" and "County Boundaries".
 
-Edit mode
+To inspect the attributes of one of the features, click on the feature in the identification panel.
+You will see all attributes of this feature appear.
+
+    .. image:: /images/projects/qfield/03_identify.png
+      :scale: 70 %
+      :alt: The hamburger menu
+
+Legend
+======
+
+To see which layers are loaded and to inspect the layer legends, click the hamburger menu on the top left corner.
+
+    .. image:: /images/projects/qfield/04_hamburger_menu.png
+      :scale: 70 %
+      :alt: The hamburger menu
+
+You will see all layers in the project listed.
+By right clicking on the layer (or long pressing on a touch screen) you will have additional actions
+available for each layer.
+
+    .. image:: /images/projects/qfield/05_legend.png
+      :scale: 70 %
+      :alt: The legend
+
+Close the legend by clicking the white arrow on the top left or by clicking anywhere on the canvas
+outside the legend panel.
+
+Edit Data
 =========
 
-How to switch to edit mode
-Drigitize a point
+By default, QField opens in read only mode and you are not able to make any changes to the data.
+To go into digitize mode:
+
+#. Click the hamburger menu on the top left corner, so you see the legend.
+#. Click the pencil switch to go into digitize mode.
+
+    .. image:: /images/projects/qfield/06_digitize_mode.png
+      :scale: 70 %
+      :alt: Switch to the digitize mode
+
+Next, we will create a new airport.
+
+#. Activate the airports layer by clicking on the `airports` layer
+#. Close the layer panel
+#. You will see a crosshair appear. This will follow your mouse or stay in the center of the screen if you are working with a touch screen.
+  #. If you have a mouse: click to create a new airport.
+  #. If you have a touchscreen, move the map until the crosshair is on the desired location and click the plus button at the bottom right of the screen to create a point.
+#. A panel appears, where you can enter all the desired attributes for the new airport
+#. Click the checkbox to confirm the new airport.
+#. The data is saved immediately.
 
 Things to try
 =============
 
-Create your own project using QGIS
-Download link for the QField sample data for more inspiration
+#. Show and hide a layer via the layer options (long click in the legend)
+#. On the legend panel, check the cog wheel symbol for more actions like measuring and printing
+#. Download the `QField sample projects`_ for more inspiration
+#. Open a project file in QGIS, add layers to it and change the configuration
+#. Install QField on your mobile device through the app store or via the `Download page`_.
 
 What next?
 ==========
@@ -72,3 +133,5 @@ What next?
 To learn more about QField, a good starting point is the `Documentation page`_.
 
 .. _`Documentation page`: https://docs.qfield.org/
+.. _`Download page`: https://docs.qfield.org/get-started/
+.. _`QField sample projects`: https://docs.qfield.org/get-started/sample-projects/