Markdown docs following full run through

Author: geographika

workshop/content/docs/advanced/symbols.md

@@ -84,13 +84,13 @@ END
     - Direct MapServer request: <http://localhost:5000/?map=/etc/mapserver/railways.map&mode=map&layer=roads>
     - Local OpenLayers example: <http://localhost:5001/railways.html>
 
-??? JavaScript
+??? JavaScript "railways.js"
 
     ``` js
     --8<-- "railways.js"
     ```
 
-??? Mapfile
+??? Mapfile "railways.map"
 
     ``` scala
     --8<-- "railways.map"

workshop/content/docs/inputs/databases.md

@@ -4,7 +4,7 @@
 
 MapServer can connect to most geospatial databases. There are native MapServer drivers for [PostgreSQL/PostGIS](https://mapserver.org/input/vector/postgis.html),
 [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 e.g. [MySQL](https://mapserver.org/input/vector/mysql.html).
+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. 

workshop/content/docs/inputs/raster.md

@@ -104,4 +104,5 @@ A [COMPOSITE](https://mapserver.org/mapfile/composite.html) block is used on the
 ## Exercises
 
 1. Try different settings for layer `OPACITY` to see its effect on the output in `raster.map`.
-2. Change the `COLOR` of the first `CLASS` in `terrain.include` to highlight which pixels have values in this range.
+2. Change the `COLOR` of the first `CLASS` in `terrain.include` to highlight which pixels have values in this range. 
+   Cyan (`COLOR 0 255 255`) is a good colour for highlighting.

workshop/content/docs/inputs/vector.md

@@ -26,8 +26,9 @@ CONNECTIONTYPE OGR
 CONNECTION "/vsicurl/https://raw.githubusercontent.com/ofrohn/d3-celestial/master/data/constellations.lines.json"
 ```
 
-+ GeoParquet, GeoArrow - use range requests to access only the data needed.
-**Cloud-Optimised** - similar to raster data formats such as "Cloud-Optimized GeoTIFFs" - COGs.
+MapServer (through GDAL) takes advantage of the newer **Cloud-Optimised** formats such as COGs - "Cloud-Optimized GeoTIFFs".
+These formats use range requests to access only the data needed, so MapServer only needs to download the data for rendering rather
+than a huge GeoTIFF file.
 
 <!--
 ## Extents

workshop/content/docs/mapfile/labels.md

@@ -59,8 +59,10 @@ GEOMTRANSFORM (centerline(densify([shape], 0.1)))
 ## Exercises
 
 1. Use a different font for the label by adding the following to the `LABEL` block: `FONT MonsieurLaDoulaise` and increasing the `SIZE` to `28`.
+   The list of fonts available can be found in `workshop/exercises/mapfiles/data/fonts/fontset.txt`.
 2. Comment out the `GEOMTRANSFORM (centerline([shape]))` and `ANGLE FOLLOW` lines (using `#`) to see its effect on the map.
-
+3. If you have time, download a font you like from https://fonts.google.com/ and unzip the .TTF file to `workshop/exercises/mapfiles/data/fonts/`
+   add a new entry to `fontset.txt` and use this font to draw your Map labels.
 <!--
 ``` xml
 <ServiceExceptionReport xmlns="http://www.opengis.net/ogc" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3.0" xsi:schemaLocation="http://www.opengis.net/ogc http://schemas.opengis.net/wms/1.3.0/exceptions_1_3_0.xsd">

workshop/content/docs/mapfile/polygons.md

@@ -104,4 +104,5 @@ CLASS
 
 3. Switch the `CONNECTIONTYPE` to use the native `FLATGEOBUF` driver.
 
-4. Experiment with styling the polygons. `WIDTH` can be used to change the width of the polygon outline.
+4. Experiment with styling the polygons. `WIDTH` can be used to change the width of the polygon outline. There are more examples
+   at [Cartographical Symbol Construction with MapServer](https://mapserver.org/mapfile/symbology/construction.html).

workshop/content/docs/outputs/vector-tiles.md

@@ -65,7 +65,8 @@ new VectorTileLayer({
 ## Exercises
 
 1. Update the layer to use the `data/naturalearth/ne_110m_lakes` dataset.
-2. Update the OpenLayers style to use a blue fill for the lakes. In the `Style` function you will need to add a
+2. Update the OpenLayers style to use a blue fill for the lakes. In the `Style` function you will need to uncomment the `fill` JavaScript.
+   Experiment with different colour values for the `fill` and `stroke`.
 
 
 

workshop/content/docs/outputs/wms.md

@@ -4,7 +4,7 @@
 
 We've been using WMS for interacting with MapServer for Mapfile examples. In this exercise we'll look in more detail at how to configure WMS services in MapServer.
 
-Full MapServer WMS documentation is available [here](https://www.mapserver.org/ogc/wms_server.html). 
+The MapServer WMS documentation is available [here](https://www.mapserver.org/ogc/wms_server.html). 
 
 ## METADATA Blocks
 
@@ -64,5 +64,7 @@ A sample request for the legend for the `polygons.map` is as follows:
 ## Exercises
 
 1. If you've read this far you deserve to discover one of MapServer's Easter eggs. Try changing the output format to `&format=image/txt`. We'll use the `polygons.map` for the request: <http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetMap&layers=buildings&format=image/txt>
-2. Change the legend title for the `polygon map`.
-3. Run a [GetCapabilities](http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetCapabilities) request for the `polygon.map`. Add various `METADATA` pairs to get rid of the warnings in the `GetCapabilities` response.
+2. Create a `GetLegendGraphic` request, but for the `points.map` for the `layer=poi`.
+3. Run a [GetCapabilities](http://localhost:5000/?map=/etc/mapserver/polygons.map&service=wms&version=1.3.0&request=GetCapabilities) request for the `polygon.map`. 
+   Add various `METADATA` pairs listed in the [Web Object Metadata](https://mapserver.org/ogc/wms_server.html#web-object-metadata) and check its output
+   in the `GetCapabilities` response.

workshop/content/mkdocs.yml

@@ -29,11 +29,11 @@ nav:
         - Vector Tiles: outputs/vector-tiles.md
         - OGC Features API: outputs/ogcfeatures.md
     - Advanced:
-        - SLD: advanced/sld.md
         - Vector Symbols: advanced/symbols.md
         - Clusters: advanced/clusters.md
-        - Apache: advanced/apache.md
-        - MapScript: advanced/mapscript.md
+        - SLD: advanced/sld.md
+        # - Apache: advanced/apache.md
+        # - MapScript: advanced/mapscript.md
     - Summary: summary.md
     - Credits and Thanks: credits.md