Updated documentation for 4.3 release

Author: GeoSander

docs/source/bridge_dialog.rst

@@ -30,18 +30,18 @@ Logging and error handling
 | This panel can be opened by clicking the "balloon" button in the lower-right corner of QGIS
   or by checking the :guilabel:`View` > :guilabel:`Panels` > :guilabel:`Log Messages` item from the QGIS menu bar.
 
-| In some (rare) occassions, |short_name| might raise an exception. When this happens, a dialog pops up with a Python strack trace.
+| In some (rare) occasions, |short_name| might raise an exception. When this happens, a dialog pops up with a Python stack trace.
 | If the error re-occurs, please press the :guilabel:`Send Report` button, so that we're aware of the issue and can try fixing it.
 
 Internationalization (i18n)
 ---------------------------
 
 |app_name| is primarily targeted towards an international audience, which means that it has an English user interface.
-| However, some rudimentary translations are available for the following languages:
+| However, some basic translations are available for the following languages:
 
 - Dutch (Nederlands)
 - German (Deutsch)
 - Spanish (Español)
 
 | The translations will be applied automatically based on the language settings of the user.
-  If no translation can be found for a certain text, the original text (English) will be displayed instead.
+  If no translation can be found for a certain text, the original text (English) will be displayed instead.

docs/source/img/bridgemenuentry.png

@@ -2,7 +2,7 @@
 =============
 
 |plugin_name| enables you to publish your map metadata to a spatial catalogue (CSW)
-like GeoNetwork opensource, or to publish the map itself as an OGC data service (WMS/WMTS/WFS/WCS)
+like GeoNetwork, or to publish the map itself as an OGC data service (WMS/WMTS/WFS/WCS)
 to GeoServer or MapServer. |short_name| also offers the option to export metadata, symbology
 and/or data as local files.
 
@@ -11,21 +11,16 @@ a Dutch-Canadian company focusing on the development, customization
 and support of cutting-edge geospatial catalog software on both server and desktop platforms.
 GeoCat provides all-in-one Spatial Data Infrastructure (SDI) solutions
 that offer a geospatial catalog, map server and map client.
-The software is based on established Free and Open Source Software (FOSS)
-projects, uses open standard protocols, and can be customized to the needs of
-different clients.
+The software is based on established Free and Open Source Software (FOSS4G)
+projects, and uses open standard protocols.
 
-The founder of GeoCat worked for many years with the United Nations Food and Agriculture Organization (FAO)
-where he founded the `GeoNetwork opensource <https://geonetwork-opensource.org>`_ project.
-Today, GeoNetwork opensource can be considered the leading open source geospatial catalog
-application with numerous international and national geo-portal implementations.
 
 Contents
 --------
 
 .. toctree::
     :glob:
-    :maxdepth: 1
+    :maxdepth: 2
 
     background
     installation

docs/source/img/first_time.png

@@ -10,6 +10,9 @@ Client-side
 |app_name| requires QGIS |min_qgis_ver| or newer.
 Both the standalone QGIS installation or the OSGeo distribution should work.
 
+QGIS users who use a QGIS version *beyond* 3.16 should verify that the ``lxml`` :ref:`Python dependency <lxml-dependency>` is available.
+However, this only applies if you wish to import or publish metadata using |short_name|.
+
 .. note::   If you access the internet through a proxy server,
             you might experience some issues while publishing data or connecting to a server.
 
@@ -19,8 +22,8 @@ Server-side
 GeoNetwork
 ^^^^^^^^^^
 
-|app_name| currently supports GeoNetwork 3 starting at version 3.4 and higher.
-GeoNetwork 2 support has been deprecated and version 4 is not supported yet.
+|app_name| currently supports GeoNetwork version 3.4 and higher.
+GeoNetwork 2.x support has been deprecated and version 4.x is not supported yet.
 
 GeoServer
 ^^^^^^^^^
@@ -35,6 +38,8 @@ GeoServer
     the REST API instead of direct access), you need to make sure that the
     `Importer extension <https://docs.geoserver.org/latest/en/user/extensions/importer/index.html>`_
     is available on GeoServer.
+    If you do not know if this extension is installed, simply try to publish
+    something and |short_name| will warn you if it isn't.
 
 MapServer
 ^^^^^^^^^
@@ -49,33 +54,31 @@ How to install
 
 To install the |plugin_name|, please follow these steps:
 
-1. Open the :guilabel:`QGIS Plugin Manager`. The Plugin Manager can be opened using the :menuselection:`Plugins --> Manage and Install plugins` menu entry.
+1. Open the :guilabel:`QGIS Plugin Manager` by clicking on the :menuselection:`Plugins --> Manage and Install Plugins...` menu entry.
 
     .. image:: ./img/pluginmanagermenu.png
 
-    You will see the following dialog:
+    You will now see a dialog similar to the one below, listing all your (pre-)installed plugins:
 
     .. image:: ./img/pluginmanager.png
 
-2. Select the :guilabel:`all` section to show all available plugins.
-
-    .. image:: ./img/pluginmanagerall.png
-
-3. In the search box, type `bridge` to filter the list of available plugins.
-
-    .. image:: ./img/pluginmanagerfiltered.png
-
-4. Click on the |gui_name| plugin entry to display the information about the plugin:
+2. Click the :guilabel:`All` section on the sidebar to list all available plugins. Scroll down to find "|gui_name|"
+or use the search box at the top to filter the list (e.g. by typing "|short_name|"). Clicking on the "|gui_name|" plugin entry
+will display detailed information about the plugin:
 
     .. image:: ./img/pluginmanagerbridge.png
 
-5. Click on :guilabel:`Install` to install the plugin.
+4. Click :guilabel:`Install Plugin` and wait until |short_name| has been downloaded and installed.
 
-6. Once the plugin is installed, close the Plugin Manager and you will find a new menu entry under the :menuselection:`Web` menu,
-which contains the menu items for the |short_name| plugin.
+5. Close the Plugin Manager when done. You should now have a new menu entry under the :menuselection:`Web` menu,
+which contains a couple of menu items related the |short_name| plugin:
 
     .. image:: ./img/bridgemenuentry.png
 
-7. You'll also notice a new toolbar button, that will open the |short_name| Publish dialog.
+6. You should also see a new toolbar button, that will open the |short_name| Publish dialog.
 
     .. image:: ./img/bridgetoolbarbutton.png
+
+
+In the Plugin Manager settings, note that you can configure QGIS to automatically check for plugin updates.
+Alternatively, you can update plugins manually using the :guilabel:`Upgrade All` button.

docs/source/img/pluginmanagerall.png

@@ -18,6 +18,7 @@ complete a minimal subset of required metadata elements:
 -   Metadata language
 
 When publishing metadata to GeoNetwork, |short_name| will convert the QGIS metadata (QMD) into the ISO19139 format.
+Note that in order to do that, |short_name| uses the ``lxml`` library, which :ref:`may not be installed <lxml-dependency>`.
 
 | You can edit the |short_name| metadata fields directly, or use the QGIS metadata editor by clicking the :guilabel:`Open QGIS metadata editor` button.
 | Note that you can also click the :guilabel:`...` buttons next to each |short_name| metadata field to open the QGIS metadata editor a specific page:
@@ -70,6 +71,8 @@ If you click :guilabel:`Yes`, a file dialog will open so you can select the meta
 
 .. note::   - Some (non-supported) elements of the original metadata may get lost in the transformation.
             - Changes in the metadata editor will not be saved to the original imported metadata file.
+            - Because of a :ref:`dependency <lxml-dependency>`, |short_name| may not be able to import metadata.
+              If this is the case, a warning will be displayed.
 
 .. warning::    | **If you wish to persist the imported/edited metadata for another time, it is important that you
                   save the QGIS project before your close the application.**