Iss 437 MAR - Setup QGIS Project

src/gis/features.md

@@ -28,9 +28,11 @@ Various online and offline maps can be used as background layers for navigation
 ![QGIS Layer Capabilities](./qgis_project_properties.jpg "QGIS Layer Capabilities")
 
 ### Project extent
-In <MobileAppName />, there is an option to [zoom to the project extent](../field/input_ui/#zoom-to-project-browse-features-map-themes-settings). 
+In <MobileAppName />, there is an option to [**Zoom to project**](../field/input_ui/#zoom-to-project-browse-features-map-themes-settings). 
 
-If the project extent is not set, <MobileAppName /> zooms to all visible layers. This is not particularly convenient when you have a layer with a large/global extent (e.g. Open Street Map).
+If the project extent is not set, <MobileAppName /> zooms to all visible layers. This is not particularly convenient when you have a layer with a large/global extent (e.g. Open Street Map). Instead, you may want to set the project extent to the area of your interest.
+
+![Zoom to project option in Mergin Maps mobile app](./mobile-app-zoom-to-project.jpg "Zoom to project option in Mergin Maps mobile app")
 
 To set the project extent:
 1. Navigate to **Project** > **Properties**. 
@@ -44,6 +46,8 @@ To set the project extent:
 
 3. Click **Apply** to save the changes
 
+4. Save and synchronise the project to <MainPlatformNameLink />. Now you can use the **Zoom to project** option in the <MobileAppNameShort /> to zoom to the extent you have specified in QGIS.
+
 
 ### Photo quality
 <SinceBadge type="Plugin" version="2022.3.2" /><SinceBadge type="App" version="1.5.1" />
@@ -138,7 +142,7 @@ Sample map tip content that will cause an image to be show specified by file pat
 file:///[%@project_folder%]/[% "image_1" %]
 ```
 
-If the map tip has `# image` marker on the first line, the following line is understood as the URL for the image. It can be a regular file on the file system, but it could be even a remote image from network. Expressions embedded in the image URL will be evaluated (enclosed in `[% 1+1 %]`).
+If the map tip has `# image` marker on the first line, the following line is understood as the URL for the image. It can be a regular file on the file system, but it could be even a remote image from the network. Expressions embedded in the image URL will be evaluated (enclosed in `[% 1+1 %]`).
 
-![Preview panel in the mobile app based on Display settings in QGIS](./input_preview_panel.jpg "Preview panel in the mobile app based on Display settings in QGIS")
+![Preview panel in the mobile app based on Display settings in QGIS](./mobile-app-preview-panel.jpg "Preview panel in the mobile app based on Display settings in QGIS")
 

src/gis/proj.md

@@ -48,7 +48,7 @@ All you need to do is:
 
 3. Download the project with the grid shift files to <MobileAppName />. 
    When the project is downloaded to the app for the first time, you will get a **PROJ Error** that will prompt you to **restart the app** to load the grid shift files. The error message should not appear after the restart of the app.
-![Mergin Maps mobile app transformation shift grid error](./input-custom-prj.jpg "Mergin Maps mobile app transformation shift grid error")
+![Mergin Maps mobile app transformation shift grid error](./mobile-app-proj-error.jpg "Mergin Maps mobile app transformation shift grid error")
 
 ### Adding grid shift files manually
 If you want to add grid shift files to the <MobileAppNameShort /> manually:
@@ -67,4 +67,5 @@ If you want to add grid shift files to the <MobileAppNameShort /> manually:
 3. Synchronise the project using the <QGISPluginNameShort />
 4. Download the project with the grid shift files to <MobileAppName />. 
    When the project is downloaded to the app for the first time, you will get a **PROJ Error** that will prompt you to **restart the app** to load the grid shift files. The error message should not appear after the restart of the app.
-![Mergin Maps mobile app transformation shift grid error](./input-custom-prj.jpg "Mergin Maps mobile app transformation shift grid error")
+
+![Mergin Maps mobile app transformation shift grid error](./mobile-app-proj-error.jpg "Mergin Maps mobile app transformation shift grid error")

src/gis/search_data.md

@@ -27,15 +27,17 @@ If a field is marked in a field configuration as **Not searchable**, it will be
 :::
 
 ## Searching for values in Mergin Maps mobile app
-Attribute data can be browsed in <MobileAppName /> by tapping **Layers** in the **More** tab. 
+Attribute data can be browsed in <MobileAppName /> by tapping **Layers**. 
 
-![Mergin Maps mobile app Layers in More tab](../field/layers/input-layers.jpg "Mergin Maps mobile app Layers in More tab")
+In the **Layers** window, choose a layer or a table from the list to open the attribute table.
 
-Choose a layer or a table from the list to open the attribute table. Here, you can browse the features. The search bar can be used to shortlist matching records. 
+![Layers overview in Mergin Maps mobile app](./mobile-app-layers.jpg "Layers overview in Mergin Maps mobile app")
+
+Here, you can browse the features. The search bar can be used to shortlist matching records. 
 
 Tap on the record to zoom to the feature on the map and display its form.
 
-![Mergin Maps mobile app browse data](./input_search_data.jpg "Mergin Maps mobile app browse data")
+![Mergin Maps mobile app browse data](./mobile-app-search-data.jpg "Mergin Maps mobile app browse data")
 
 :::tip
 The search looks up for a match in all searchable attributes values and is not case sensitive.

src/gis/setup_themes.md

@@ -1,21 +1,28 @@
 # Map Themes
 [[toc]]
 
-In <MobileAppName />, you can use different **map themes**. This is ideal for switching between different background maps (e.g. cartography map and aerial photography). The map themes should be first set up in QGIS.
+In <MobileAppName />, you can use different **map themes**. This is ideal for switching between different background maps (e.g. cartography map and aerial photography), combinations of visible layers or their styles. The map themes should be first set up in QGIS.
 
 ## Setting up QGIS map themes
 
-Read how to <QGISHelp ver="3.22" link="user_manual/introduction/general_tools.html#configuring-map-themes" text="set up a new map theme" /> in QGIS.
+Read how to <QGISHelp ver="latest" link="user_manual/introduction/general_tools.html#configuring-map-themes" text="set up a new map theme" /> in QGIS.
 
-- Open QGIS Desktop with your QGIS Project 
-- In the Layers Panel, click on "Manage Map Themes" (eye-icon)
+- Open QGIS Desktop with your QGIS Project
+- Define the visibility and/or styles of the layers in your project
+- In the Layers Panel, click on "Manage Map Themes" (eye-icon) and add a new theme (or replace an existing one)
+
+Here, we created two themes: `OSM` and `Aerial photos` to easily switch between two types of background maps.
 ![QGIS Map Themes setup](./qgis_map_themes_setup.jpg "QGIS Map Themes setup")
-- Add new themes or replace existing themes.
 
 ## Map themes in Mergin Maps mobile app
-To access the Map Themes, select **More** > **Map themes**. The list of the Map Themes should appear as a pop up.
+In the <MobileAppNameShort />, tap **More** and select the **Map themes** option.
+
+![Map themes option in Mergin Maps mobile app](./mobile-app-map-themes-option.jpg "Map themes option in Mergin Maps mobile app")
+
+Now you will see the list of map themes that are available in your project. To switch the map theme, tap on it.
+
+Here, we switched from `OSM` to `Aerial photos`. 
+
+![Mergin Maps mobile app switching map themes](./mobile-app-map-themes-switch.jpg "Mergin Maps mobile app switching map themes")
 
-![Mergin Maps mobile app OpenStreetMap](./input_map_themes_osm.jpg "Mergin Maps mobile app OpenStreetMap")
-![Mergin Maps mobile app Map Themes](./input_map_themes_base.jpg "Mergin Maps mobile app Map Themes")
-![Mergin Maps mobile app switch map themes](./input_map_themes_switch.jpg "Mergin Maps mobile app switch map themes")
-![Mergin Maps mobile app switched map theme](./input_map_themes_alt.jpg "Mergin Maps mobile app switched map theme")
+It may be useful to define a *default* map theme for your project. Then, If you change the visibility of layers through the [**Layers**](../field/layers/) option in the <MobileAppNameShort /> during the survey, you can use this map theme to get back to the default setup.

src/gis/snapping/index.md

@@ -26,7 +26,7 @@ To set up basic snapping:
 Now you can use basic snapping in <MobileAppName />! 
 
 When capturing a new feature near an existing one, the crosshairs will turn purple and snap to its vertex (left) or to its segment (right).
-![Mergin Maps mobile app crosshairs when snapping](./input_basic_snapping.jpg "Mergin Maps mobile app crosshairs when snapping")
+![Mergin Maps mobile app crosshairs when snapping](./mobile-app-basic-snapping.jpg "Mergin Maps mobile app crosshairs when snapping")
 
 :::tip
 If you don't want the crosshairs to snap to a feature, try zooming in. The snapping threshold is 20 pixels, so the more you zoom in, the closer you can place the vertex to the existing geometry without snapping.