Text updates and fixes in final review (#15)

Author: geographika

workshop/content/docs/advanced/apache.md

@@ -6,12 +6,12 @@
 
 ## Overview
 
-The Apache web server is used by the workshop Docker image. Since version 8.0 MapServer has a global config file.
-
 At its heart MapServer is a command-line application that can be accessed through a web server.
 
+The Apache web server is used by the workshop Docker image.
+
 Apache has a [configuration file](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/etc/apache2/conf-enabled/mapserver.conf).
-The Docker image uses a [start-up script(https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/start-server).
+The Docker image uses a [start-up script](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/start-server).
 
 MapServer uses the [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), which is an Apache module that provides FastCGI support.
 
@@ -24,9 +24,9 @@ FcgidIdleTimeout ${IDLE_TIMEOUT}
 FcgidIOTimeout ${IO_TIMEOUT}
 ```
 
-These are all documented on the [reference page(https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html).
+These are all documented on the [reference page](https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html).
 
-These all have defaults in the Docker file, but can be overridden using environment variables.
+These all have defaults in the Docker file, but can be overridden using Docker environment variables.
 
 ```
 ENV MS_DEBUGLEVEL=0 \

workshop/content/docs/advanced/debugging.md

@@ -1,6 +1,8 @@
 # Debugging MapServer
 
-TODO
+!!! warning
+
+    This page is currently in a draft form.
 
 ```scala
     LAYER
@@ -14,4 +16,6 @@ TODO
 
 Then follow live logs:
 
-docker logs -f mapserver
+```
+docker logs -f mapserver
+```

workshop/content/docs/advanced/gdalg.md

@@ -15,6 +15,19 @@ MapServer reads a vector pipeline using the [GDALG: GDAL Streamed Algorithm](htt
   <iframe src="https://mapserver.github.io/getting-started-with-mapserver-demo/gdalg.html"></iframe>
 </div>
 
+The pipeline we will be running in this example reads a dataset from a FlatGeoBuf file, and applies
+a buffer to it:
+
+<div>
+<object
+    type="image/svg+xml"
+    data="/assets/images/roads.gdalg.svg"
+    width="100%"
+    height="200">
+</object>
+</div>
+
+
 ## Checking the Pipelines with GDAL
 
 Before configuring MapServer, it is often easier to test your pipelines directly with GDAL, to ensure they run correctly.

workshop/content/docs/credits.md

@@ -4,12 +4,17 @@ title: Credits
 
 # Authors
 
-- [Seth Girvin](https://geographika.net/) (found on GitHub at [@geographika](https://github.com/geographika)). Please get in touch if you'd like a particular topic added to the workshop, or require any MapServer development.
+- [Seth Girvin](https://geographika.net/) (found on GitHub at [@geographika](https://github.com/geographika),
+  and Mastodon at [@geographika](https://mastodon.social/@geographika)).
+  Please get in touch if you'd like a particular topic added to the workshop, or require any MapServer development.
 
 # Thanks
 
 Thanks to the following for helping this workshop to be created and improved:
 
+- The workshop participants at [FOSS4G Europe 2025](https://2025.europe.foss4g.org/) in Mostar, for their enthusiasm and feedback.
+- [Even Rouault](https://www.osgeo.org/member/even-rouault/) and [Tom Kralidis](https://www.osgeo.org/member/tom-kralidis/) for
+  assisting, and valuable comments and additions at FOSS4G Europe 2025.
 - The workshop participants at [FOSS4G Europe 2024](https://2024.europe.foss4g.org/) for their participation, feedback, and for having everything installed ready for a 9am start!
 - [Michael Smith](https://www.osgeo.org/member/michael-smith/) for co-hosting the FOSS4G Europe 2024 workshop, and providing valuable tips and assistance.
 - Colleagues at [Compass Informatics](https://compass.ie/) for trialling the workshop and providing valuable feedback.

workshop/content/docs/inputs/databases.md

@@ -6,12 +6,13 @@ MapServer can connect to most geospatial databases. There are native MapServer d
 [Oracle](https://mapserver.org/input/vector/oracle.html), and [Microsoft SQL Server](https://mapserver.org/input/vector/mssql.html). Other databases
 can be accessed through OGR, for example [MySQL](https://mapserver.org/input/vector/mysql.html).
 
-In this exercise we'll be connecting to a PostGIS database to display water polygon features using a MapServer WMS. [PostGIS](https://postgis.net/) spatially enables the [PostgreSQL](https://www.postgresql.org/)
-databases. 
+In this exercise we'll be connecting to a PostGIS database to display water polygon features using a MapServer WMS.
+[PostGIS](https://postgis.net/) spatially enables [PostgreSQL](https://www.postgresql.org/) databases. 
+
 
 ## Docker Setup
 
-To avoid having to install and setup a database we'll be using the [PostGIS Docker image](https://hub.docker.com/r/kartoza/postgis/) provided
+To avoid having to install and set up a database we'll be using the [PostGIS Docker image](https://hub.docker.com/r/kartoza/postgis/) provided
 by [Kartoza](https://kartoza.com/).
 
 !!! info
@@ -52,7 +53,7 @@ creating a new PostgreSQL connection:
 
 ## Adding Data to The Database
 
-We can use the OGR tool [ogr2ogr](https://gdal.org/programs/ogr2ogr.html) installed on the MapServer container to add datasets to the PostgreSQL database.
+We can use the GDAL CLI tool [gdal vector convert](https://gdal.org/en/stable/programs/gdal_vector_convert.html) installed on the MapServer container to add datasets to the PostgreSQL database.
 
 ```bash
 # connect to the MapServer Docker image which includes OGR tools for importing data
@@ -95,10 +96,10 @@ Online example not available as no PostGIS installation on the server
 
 ## Exercises
 
-1. Try and load another dataset into the database using the `ogr2ogr` approach above.
+1. Try to load another dataset into the database using the `gdal vector convert` approach above.
 2. Now add a new layer to the Mapfile to display the layer. You can make a direct request to MapServer in the form:
   <http://localhost:7000/?map=/etc/mapserver/postgis.map&mode=map&layers=water%20NEWLAYERNAME>.
-3. Now update the JS file so the layer is visible as part of the interactive map, through WMS:
+3. Now update the JS file so the layer is visible in the interactive map via WMS:
 
     ```js
       source: new ImageWMS({

workshop/content/docs/inputs/raster.md

@@ -3,9 +3,8 @@
 ## Overview
 
 MapServer can serve both [vector](https://mapserver.org/input/vector/index.html) and [raster](https://mapserver.org/input/raster.html) data.
-
 The dataset used in this example is elevation data from the [Estonian Geoportal](https://geoportaal.maaamet.ee/eng/Spatial-Data/Elevation-Data-p308.html),
-and data provided by the Estonian Land Board 2024. It covers Tartu center and is from map sheet 474659.
+provided by the Estonian Land Board (2024). It covers Tartu center and is from map sheet 474659.
 
 <div class="map">
   <iframe src="https://mapserver.github.io/getting-started-with-mapserver-demo/raster.html"></iframe>
@@ -47,7 +46,7 @@ LAYER
 END
 ```
 
-There are a few points to note in this Mapfile. 
+There are a few points to note about this Mapfile.
 
 ## Include Files
 
@@ -80,7 +79,7 @@ END
 
 ## Composite Blocks
 
-A [COMPOSITE](https://mapserver.org/mapfile/composite.html) block is used on the layer to make it 20% transparent.
+A [COMPOSITE](https://mapserver.org/mapfile/composite.html) block is used to make the layer 20% transparent.
 
 ## Code
 

workshop/content/docs/inputs/vector.md

@@ -19,7 +19,7 @@ MapServer documentation.
 ## Remote Datasets using  Virtual File Systems
 
 GDAL's [Virtual File Systems](https://gdal.org/user/virtual_file_systems.html) can be used to
-access data over stored on a network, for example on a server or Amazon S3 bucket. 
+access data stored on a network, for example on a server or Amazon S3 bucket. 
 
 ```scala
 CONNECTIONTYPE OGR
@@ -75,7 +75,7 @@ than a huge GeoTIFF file.
     END
     ```
 
-    In the `stars.js` you will need to ensure the `milkyway` layer is added to the OpenLayers map:
+    In the `stars.js` file you will need to ensure the `milkyway` layer is added to the OpenLayers map:
 
     ```js
     params: { 'LAYERS': 'constellations,stars,stars2,milkyway'},

workshop/content/docs/introduction/commandline.md

@@ -19,7 +19,7 @@ INPUT=OGR INPUT=GDAL INPUT=SHAPEFILE INPUT=FLATGEOBUF
 ```
 
 When run through a web server, data is passed to the `mapserv` application, which generates output that is then sent back through the web server.
-All web requests can be recreated and tested on the command line, this makes it a handy debugging tool. 
+All web requests can be recreated and tested on the command line, making it a handy debugging tool.
 
 To test a URL such as <http://localhost:7000/?map=/etc/mapserver/countries.map&mode=map> run the following command:
 
@@ -31,21 +31,21 @@ This will output a PNG image to the command line - this will look like garbage!
 
 We can save the output by redirecting it to a file using `>`. 
 As the `mapserv` program returns responses for a web client it also returns HTTP headers. To create a valid image file we need to strip these
-header by using the `-nh` (no headers) switch.
+headers by using the `-nh` (no headers) switch.
 
 ```bash
 mapserv -nh "QUERY_STRING=map=/etc/mapserver/countries.map&mode=map" > /etc/mapserver/test.png
 ```
 
-`test.png` should now be on your local disk at `getting-started-with-mapserver/workshop/exercises/mapfiles`.
+`test.png` should now be available on your local disk at `getting-started-with-mapserver/workshop/exercises/mapfiles`.
 
 ![Test output generated at the command line](../assets/images/command-line-test.png)
 
 !!! tip
 
     The `docker-compose.yml` file maps local folders to folders on the Docker container. Files created in the Docker
     container will be visible on your local disk, and files on your local disk will be visible in the container.
-    This is set in in the `volumes` section, using the syntax ` - LOCAL_FOLDER:CONTAINER_FOLDER`
+    This is set in the `volumes` section, using the syntax ` - LOCAL_FOLDER:CONTAINER_FOLDER`
 
     ```yaml
     volumes:

workshop/content/docs/introduction/docker.md

@@ -6,12 +6,12 @@ We will be using MapServer on a Docker image for the workshop. This ensures that
 
 A custom MapServer Docker image has been created for the workshop, and the Dockerfile is found [here](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/Dockerfile). 
 
-MapServer runs on the Apache web server - see the [Apache page](../advanced/apache.md) page for further details. 
+MapServer runs on the Apache web server - see the [Apache page](../advanced/apache.md) for further details. 
 
-It uses the Apache [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), module that provides FastCGI support.
+It uses the Apache [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), a module that provides FastCGI support.
 
 MapServer runs on port `8080` on the Docker container, which is mapped to port `7000` on the local machine, as can be seen in the Docker compose file
-located at `workshop\exercises\docker-compose.yml`:
+located at `workshop/exercises/docker-compose.yml`:
 
 ```yaml
   mapserver:
@@ -30,7 +30,7 @@ located at `workshop\exercises\docker-compose.yml`:
 
 ## JavaScript Application
 
-A second container that serves the JavaScript example pages is also run using Docker. This uses Node and runs on port 7001 on both the container and the host machine.
+A second Docker container serves the JavaScript example pages. This uses Node and runs on port 7001 on both the container and the host machine.
 
 ```yaml
   node:

workshop/content/docs/introduction/introduction.md

@@ -18,17 +18,17 @@ MapServer. Both vector data and raster data are covered.
 
 4. MapServer **Outputs**. These exercises show how MapServer can publish data. When first
 created MapServer was used to produce map images, but now it can serve data out in
-a large number of open geospatial formats. Focus is given to [OGC](https://www.ogc.org/standards/)
+a large number of open geospatial formats. The focus is on [OGC](https://www.ogc.org/standards/)
 standards as these are free, open and interoperable.
 
 5. **Advanced** topics. These are a collection of miscellaneous exercises that cover
 a wide range of MapServer functionality. Selected exercises will be chosen based on the
-needs to the workshop participants. MapServer has over 25 years of development and 
+needs of the workshop participants. MapServer has over 25 years of development and 
 features, so new topics will be added over time. 
 
 ## Workshop Outline
 
-Below is a rough timeline for how the timings of the 4-hour workshop, with a 15 minute break.
+Below is a rough timeline for the 4-hour workshop, including a 15-minute break.
 These can be adapted based on the needs of the participants.
 
 - 0h00 - 0h30 - Introduction to the workshop, Docker setup and tests
@@ -43,7 +43,7 @@ These can be adapted based on the needs of the participants.
 ## Test the Docker Compose config
 
 Before making any changes, we will make sure that the initial Docker Compose
-setup provided to you is actually working. The configuration file for Docker Compose is found at the following location:
+setup provided to you is actually working. The Docker Compose configuration file is located at:
 
 * `workshop/exercises/docker-compose.yml`
 
@@ -59,9 +59,9 @@ setup provided to you is actually working. The configuration file for Docker Com
     2. Open <http://localhost:7000> in your browser, you should see an error message!
     3. Close by pressing `CTRL-C`
 
-# Displaying your First Map
+# Displaying Your First Map
 
-- Ensure that you have MapServer setup and running at <http://localhost:7000>.
+- Ensure that you have MapServer set up and running at <http://localhost:7000>.
 - Now try opening the following MapServer URL in your browser - <http://localhost:7000/?map=/etc/mapserver/countries.map&mode=map>