docs: minor tweaks to a few places (#2587)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

docs/content/run-hosting-environment/index.md

@@ -3,7 +3,7 @@
 You can run Martin behind NGINX proxy, so you can cache frequently accessed tiles with custom logic.
 Here is an example `docker-compose.yml` file that runs Martin with NGINX and PostgreSQL.
 
-```yml
+```compose
 --8<-- "files/compose.nginx.yaml"
 ```
 

docs/content/run-with-nginx.md

@@ -1,6 +1,6 @@
 # Reverse Proxies
 
-Martin can run without a reverse proxy.
+Martin **can run without** a reverse proxy.
 
 Doing so has a few downsides:
 
@@ -9,7 +9,12 @@ Doing so has a few downsides:
   This means anybody can point their dns record to your server and serve to all requests going to the port Martin is running on.
   Using a reverse proxy makes this abuse obvious.
 - Martin only supports a simple in-memory caching.
-  If you need more advanced caching options, you can use a reverse proxy like [Nginx](https://nginx.org/), [Varnish](https://varnish-cache.org/), or [Apache](https://httpd.apache.org/) with custom rules.
-  For example, you may choose to only cache zoom 0..10.
-- You may need to host more than just tiles at a single domain name.
-- Martin has a fixed public API, but your site may require a different structure, e.g. serving tiles with from a sub-path like `/tiles/source/z/x/y`.
+  If you need more advanced caching options, you can use a reverse proxy with custom rules.
+  You may for example only want to cache zoom `0..10`.
+  Here are some reverse proxy options:
+    - [Nginx](https://nginx.org/)
+    - [Varnish](https://varnish-cache.org/)
+    - [Apache](https://httpd.apache.org/)
+- You may need to host more than just tiles/resources on the domain name.
+- Martin has a fixed public API, but your site may require a different structure.
+  For example, you may want to serve tiles from `/{sourceID}/tiles?z={z}&x={x}&y={y}` instead of `/{sourceID}/{z}/{x}/{y}`.

docs/content/run-with-reverse-proxy/index.md

@@ -16,3 +16,6 @@ L.vectorGrid
   })
   .addTo(map);
 ```
+
+!!! warning
+    Style serving is specific to [maplibre](https://maplibre.org/martin/using-with-maplibre/) or [deck.gl](https://maplibre.org/martin/using-with-deckgl/).

docs/content/sources-resources/index.md

@@ -14,3 +14,6 @@ const layer = new VectorTileLayer({
 });
 map.addLayer(layer);
 ```
+
+!!! warning
+    Style serving is specific to [maplibre](https://maplibre.org/martin/using-with-maplibre/) or [deck.gl](https://maplibre.org/martin/using-with-deck-gl/).

docs/content/using-with-leaflet.md

@@ -29,57 +29,10 @@ as `/points`, `/points.1`, etc.
 Some source IDs are reserved for internal use. If you try to use them, they will be automatically renamed to a unique ID
 the same way as duplicate source IDs are handled, e.g. a `catalog` source will become `catalog.1`.
 
-Some of the reserved IDs: `_`, `catalog`, `config`, `font`, `health`, `help`, `index`, `manifest`, `metrics`, `refresh`,
+Here are the reserved source IDs:
+`_`, `catalog`, `config`, `font`, `health`, `help`, `index`, `manifest`, `metrics`, `refresh`,
 `reload`, `sprite`, `status`.
 
-### Catalog
-
-A list of all available sources is available via catalogue endpoint:
-
-```bash
-curl localhost:3000/catalog | jq
-```
-
-```yaml
-{
-  "tiles" {
-    "function_zxy_query": {
-      "name": "public.function_zxy_query",
-      "content_type": "application/x-protobuf"
-    },
-    "points1": {
-      "name": "public.points1.geom",
-      "content_type": "image/webp"
-    },
-    ...
-  },
-  "sprites": {
-    "cool_icons": {
-      "images": [
-        "bicycle",
-        "bear",
-      ]
-    },
-    ...
-  },
-  "fonts": {
-    "Noto Mono Regular": {
-      "family": "Noto Mono",
-      "style": "Regular",
-      "glyphs": 875,
-      "start": 0,
-      "end": 65533
-    },
-    ...
-  },
-  "styles": {
-    "maplibre_demo": {
-      "path": "path/to/maplibre_demo.json",
-    },
-  },
-}
-```
-
 ### Source TileJSON
 
 All tile sources have a [TileJSON](https://github.com/mapbox/tilejson-spec) endpoint available at the `/{SourceID}`.
@@ -91,3 +44,53 @@ and `lines` sources will be available at `/points,lines` endpoint.
 curl localhost:3000/points | jq
 curl localhost:3000/points,lines | jq
 ```
+
+### Catalog
+
+A list of all available sources is available via catalogue endpoint
+
+```bash
+curl localhost:3000/catalog | jq
+```
+
+??? example "Example"
+
+    ```yaml
+    {
+      "tiles" {
+        "function_zxy_query": {
+          "name": "public.function_zxy_query",
+          "content_type": "application/x-protobuf"
+        },
+        "points1": {
+          "name": "public.points1.geom",
+          "content_type": "image/webp"
+        },
+        ...
+      },
+      "sprites": {
+        "cool_icons": {
+          "images": [
+            "bicycle",
+            "bear",
+          ]
+        },
+        ...
+      },
+      "fonts": {
+        "Noto Mono Regular": {
+          "family": "Noto Mono",
+          "style": "Regular",
+          "glyphs": 875,
+          "start": 0,
+          "end": 65533
+        },
+        ...
+      },
+      "styles": {
+        "maplibre_demo": {
+          "path": "path/to/maplibre_demo.json",
+        },
+      },
+    }
+    ```

docs/content/using-with-openlayers.md

@@ -38,7 +38,6 @@ nav = [
     {"Command Line Interface" = "run-with-cli.md"},
     {"Environment Variables" = "env-vars.md"},
     {"Hosting Environment-specific Guides" = [
-        "run-hosting-environment/index.md",
         {"Docker" = "run-with-docker.md"},
         {"Docker Compose" = "run-with-docker-compose.md"},
         {"AWS Lambda" = "run-with-lambda.md"}
@@ -64,7 +63,6 @@ nav = [
         {"Composite Sources" = "sources-composite.md"}
     ]},
     {"Supporting Resources" = [
-        "sources-resources/index.md",
         {"Sprites" = "sources-sprites.md"},
         {"Styles" = "sources-styles.md"},
         {"Fonts" = "sources-fonts.md"}