Iss 437 tutorial mobile - redesign (#523)

src/field/mobile-app-ui/index.md

@@ -77,7 +77,7 @@ To see your current position and GPS info, you have to enable location services
 
 Tapping the **location button** in the right bottom corner of the screen centres the map to your current position and keeps it centred while you are moving. If you move the map manually, the auto-centre mode turns off automatically.
 
-![Mergin Maps mobile app GPS accuracy](./mobile-app-center-to-current-position.jpg "Mergin Maps mobile app GPS accuracy") 
+![Mergin Maps mobile app centre to current position](./mobile-app-center-to-current-position.jpg "Mergin Maps mobile app centre to current position") 
 
 In the left bottom corner of the screen, there is a **GPS** button that displays the GPS accuracy as reported by your mobile device. The colour of the button denotes the accuracy threshold set in [GPS settings](#gps-settings) in the <MobileAppNameShort />.
 

src/tutorials/creating-a-project-in-qgis/index.md

@@ -156,3 +156,7 @@ Synchronising changes between users and devices is a core principle of <MainPlat
 
 Changes are merged safely and easily from different users, even when they edit the same feature. <MainPlatformNameLink /> tracks project version history so you can download a previous version of a project if you need to.
 
+:::tip Public project available
+The project created in this tutorial <MerginMapsProject id="documentation/t3-trees-and-hedges" /> is public. If needed, you can download it and compare it with your results.
+:::
+

src/tutorials/mobile/index.md

@@ -2,131 +2,108 @@
 
 [[toc]]
 
-::: warning
-Our mobile app was redesigned. We are in the process of updating this content to reflect these changes.
-:::
-
 In the last tutorial we created a new <MainPlatformName /> project in QGIS with layers for surveying trees and hedges. You'll now learn how to:
 * Open the QGIS project in <MobileAppName />
-* Set GPS accuracy thresholds
 * Switch between layers to capture new point and linear features
-* Sync and save your data in <MainPlatformNameLink /> cloud
+* Sync and save your data to <MainPlatformNameLink /> cloud
 
-:::tip
-Need help navigating <MobileAppName />? [<MobileAppName /> Interface](../../field/mobile-app-ui/) contains the overview of the functionality of the app's buttons and features.
+:::tip Need help navigating the mobile app?
+[<MobileAppName /> interface](../../field/mobile-app-ui/) contains the overview of the features and functionality of the <MobileAppNameShort />.
 :::
 
 ## Opening the project on your mobile device 
 1. Open <MobileAppName /> on your mobile device
-2. Open the **My projects** tab of the **Projects** page
-3. **Download** the ***trees-and-hedges*** project:
+2. Go to the **Projects** tab. Here, you can see a list of projects in your workspace.
+3. **Download** the ***trees-and-hedges*** project.
    ![Downloading project from Projects tab](./merginmaps-mobile-download-my-project.jpg "Downloading project from Projects tab")
-
-   The project should now be downloaded to the device:
-   ![Downloading project progress bar](./merginmaps-mobile-project-downloading.jpg "Downloading project progress bar")
-
-4. Switch to the **Home** tab and tap the ***trees-and-hedges project***
+4. Projects that are downloaded to your mobile device are listed in the **Home** tab. 
+   Tap the ***trees-and-hedges project*** to open it in the <MobileAppNameShort />.
    ![Open downloaded project from Home tab](./merginmaps-mobile-open-project.jpg "Open downloaded project from Home tab")
+5. Pinch the screen to zoom in on your location. If you lose sight of your location, use the **GPS button** in the right corner of the map window to recentre the map on your position.
+   ![Recentring position of the map](./merginmaps-mobile-centre-gps.jpg "Recentring position of the map")
 
-   The project should now be shown:
-   ![Project opened in Mergin Maps mobile app](../capturing-first-data/merginmaps-mobile-location-shown-on-osm.jpg "Project opened in Mergin Maps mobile app")
+::: tip Location has to be enabled
+To display your current position on the map, the location has to be enabled on your mobile device and the <MobileAppNameShort /> needs permission to use it. 
+:::
 
-5. Pinch the screen to zoom in on your location. If you lose sight of your location, use the **GPS button** to recentre the map on your position.
 
 ## GPS accuracy
-Current GPS accuracy affects the quality of field data that you capture in the field. 
+Current GPS accuracy affects the quality of field data that you capture in the field and how accurately is your position displayed on the map. 
 
-Let's see what can happen when capturing field data. Press the **Record** button:
-![Entering recording mode in Mergin Maps mobile app](../capturing-first-data/merginmaps-mobile-record.jpg "Entering recording mode in Mergin Maps mobile app")
-
-You may now see a warning about GPS accuracy:
-![Low GPS accuracy warning](./merginmaps-mobile-gps-accuracy-warning.jpg "Low GPS accuracy warning")
+The estimated uncertainty of your current position is displayed around the position marker. Current GPS accuracy is reported in the bottom left corner of the map window. Tap it to get more information about current GPS status.
 
-What does it mean? When GPS accuracy falls below a threshold, <MobileAppName /> reports this to the user using this warning. This threshold can be changed and it is highly recommended to set it to a sensible value as described below.
-
-The <MobileAppNameShort /> uses a traffic light system to display GPS status:
-* Green: OK - GPS accuracy within defined threshold
-* Orange: Warning - GPS accuracy outside of defined threshold
-* Red: No GPS - there's no GPS signal or the GPS is unavailable
+![GPS accuracy info in Mergin Maps mobile app](./merginmaps-mobile-accuracy-spot-and-bubble.jpg "GPS accuracy info in Mergin Maps mobile app")
 
-The current value of GPS accuracy, traffic light dot and accuracy bubble is displayed here:
-   ![GPS accuracy info in Mergin Maps mobile app](./merginmaps-mobile-accuracy-spot-and-bubble.jpg "GPS accuracy info in Mergin Maps mobile app")
+The <MobileAppNameShort /> uses colours to report whether the GPS accuracy falls within the defined threshold (green) or if it is outside of defined threshold and captured position can be inaccurate (orange). The threshold can be changed in the [Settings](../../field/mobile-app-ui/#gps-settings).
 
-### How to change the GPS accuracy threshold
-1. Cancel recording and open **Settings**:
-   ![Open settings in Mergin Maps mobile app](./merginmaps-mobile-open-settings.jpg "Open settings in Mergin Maps mobile app")
+::: tip Understanding GPS accuracy
+[GPS accuracy](../../field/gps_accuracy/) provides more detail about this topic.
+:::
 
-3. **Set Accuracy** threshold to a sensible value
-   Typical values could range between 2m and 25m and typically depend on the accuracy of your mobile device and your use case. Higher accuracy can be achieved by using [external GPS antenna](../../field/external_gps/).
-   ![Accuracy threshold setup in Settings](./merginmaps-mobile-setting-accuracy-threshold.jpg "Accuracy threshold setup in Settings")
 
-   Watch the traffic light change colour as you change the accuracy threshold.
 
 ## The active layer
-In a moment we'll survey a tree. Surveyed features are added to the **active layer**. The project contains three different layers so we'll now ensure the ***trees*** layer is set as the active layer.
+In a moment we'll survey a tree. Surveyed features are added to the ***active layer***. The project contains three different layers so we'll now ensure the ***trees*** layer is set as the active layer.
 
-1. Press the **Record** button:
-   ![Entering the recording mode in Mergin Maps mobile app](../capturing-first-data/merginmaps-mobile-record.jpg "Entering the recording mode in Mergin Maps mobile app")
+1. Press the **Add** button to enter the *recording* mode.
 
-   The active layer is shown just above the button bar:
-   ![Active layer highlighted in Mergin Maps mobile app](./merginmaps-mobile-active-layer.jpg "Active layer highlighted in Mergin Maps mobile app")
+   Current active layer is displayed on the top of the map window.
+   ![Active layer in Mergin Maps mobile app](./merginmaps-mobile-active-layer.jpg "Active layer in Mergin Maps mobile app")
 
-2. Tap the active layer and set it to ***trees***:
+2. Tap the active layer and set it to ***trees***.
    ![List of editable layers](./merginmaps-mobile-active-layer-set-to-trees.jpg "List of editable layers")
 
-3. Press the **Add Point** button to survey a new tree.
+3. Now we can survey a new tree by tapping the **Record** button. 
 
-   Notice how the form (e.g. species drop-down list) reflects how we configured the project in QGIS:
+   Notice how the form reflects how we configured the species drop-down list in QGIS:
    ![Drop down form in Mergin Maps mobile app](./merginmaps-mobile-forms-with-drop-down.jpg "Drop down form in Mergin Maps mobile app")
 
-4. Enter some values and **Save** the new point
+4. Fill in the form and **Save** :heavy_check_mark: the new point
+   ![Save new feature in Mergin Maps mobile app](./merginmaps-mobile-save-feature.jpg "Save new feature in Mergin Maps mobile app")
+
 
 ## Editing features and the preview panel
 Tapping a map feature shows its preview panel.
 
-1. Tap the tree you just surveyed:
+1. Tap a feature on the map.
    ![Detail of surveyed tree](./merginmaps-mobile-default-preview-panel.jpg "Detail of surveyed tree")
 
    Information shown in the preview panel can be customised. We'll learn how in the next tutorial.
 
-2. Experiment with editing the tree's species and location using the **edit** button:
-   ![Edit button icon](./merginmaps-mobile-edit-button.jpg "Edit button icon")
+2. Experiment with editing the feature by tapping the **Edit** button.
 
-   The edit button can be used to edit the feature's attributes (e.g. species, condition) and even its location/geometry.
+   Change the values in the form (e.g. the tree species) or use the **Edit geometry** button to modify the location of the feature. 
+   ![Edit attributes and geometry of a feature](./merginmaps-mobile-edit-feature.jpg "Edit attributes and geometry of a feature")
 
 ## Survey linear features
 
-When creating the project in QGIS, we included a layer for linear features called ***hedges***. We'll now learn how to survey lines in the <MobileAppNameShort />.
+When creating the project in QGIS, we included a layer for linear features called ***hedges***. We'll now learn how to survey lines in the <MobileAppNameShort />. Areas can be captured in a similar way to lines if the project has editable polygon layers. 
 
-::: tip
-Areas can be captured in a similar way to lines if the project has editable area/polygon layers.
+::: tip More about capturing features 
+[How to add, edit, delete features](../../field/mobile-features/) has more details about capturing and editing features in the <MobileAppNameShort />.
 :::
 
-1. Set ***hedges*** as the **active layer**.
-
-   Refer back to [the active layer section](#the-active-layer) if you cannot remember how to do this.
-
-   We'll now survey a hedge feature.
+1. We'll now survey a hedge feature. 
 
-2. Use tools in the bottom panel to survey the line: use **Add Point** to add points along the line and tab **Done** when finished
-   ![Surveying line feature in Mergin Maps mobile app](./merginmaps-mobile-digitising-line.jpg "Surveying line feature in Mergin Maps mobile app")
+   Set ***hedges*** as the **active layer** as described in [the active layer section](#the-active-layer).
 
-::: tip
-Drag the map to position points manually or press **GPS** to recentre the map on your location.
-:::
+2. Use tools in the bottom panel to survey the line: use **Add** to add vertices along the line and tab the **Record** button when finished.
+
+   If needed, use **Remove** or **Undo** to change the feature's geometry.
+   ![Surveying line feature in Mergin Maps mobile app](./merginmaps-mobile-digitising-line.jpg "Surveying line feature in Mergin Maps mobile app")
 
 3. Enter some **attributes** and a **photo** for the hedge:
    ![Feature form in Mergin Maps mobile app](./merginmaps-mobile-hedge-attributes-and-photo.jpg "Feature form in Mergin Maps mobile app")
 
-When I surveyed my hedge, it was quite difficult to distinguish from the background map - it was a thin, light green line: 
+It may happen that the surveyed hedge can be quite difficult to distinguish from the background map. For instance here, the line is too thin and does not have the best colour. 
 ![Poor symbology of feature on the map](./merginmaps-mobile-poor-symbology.jpg "Poor symbology of feature on the map")
 
 We will learn how to change layer styles in the [next tutorial](../further-project-customisation/).
 
 ## Saving data to the cloud
-To conclude this tutorial we will push the data we just collected back to <MainPlatformNameLink />.
-1. Open the **Home** tab of the **Projects** page
-2. Press the sync button:
-   ![Synchronising changes to Mergin Maps cloud](./merginmaps-mobile-sync-project.jpg "Synchronising changes to Mergin Maps cloud")
+To conclude this tutorial we will save the data we just collected back to <MainPlatformNameLink />.
+
+Tap the **Sync** button in the bottom navigation panel and wait for notification about successful synchronisation.
+![Synchronising changes to Mergin Maps cloud](./merginmaps-mobile-sync-project.jpg "Synchronising changes to Mergin Maps cloud")
 
 When the sync process has completed your data has been stored safely in the cloud.