add docs on cluster command.

Author: bdon

pmtiles/cli.md

@@ -171,6 +171,18 @@ Options:
 * `--no-deduplication`: Do not attempt to de-duplicate tile contents. Use this to speed up `convert` if you know the input has only unique tiles.
 * `--tmpdir`: specify the location of the temporary directory.
 
+### cluster
+
+Cluster an unclustered existing archive, optimizing the size and layout. Archives created by tippecanoe, planetiler, and the pmtiles CLI are already clustered.
+
+```bash
+pmtiles cluster INPUT.mbtiles
+```
+
+Options:
+
+* `--no-deduplication`: Do not attempt to de-duplicate tile contents. Use this to speed up `cluster` if you know the input has only unique tiles.
+
 ### upload
 
 Upload an archive to cloud storage.

pmtiles/create.md

@@ -70,4 +70,4 @@ Run the basemaps program on your own computer to modify the layers or generate o
 
 ## Tilemaker
 
-[Tilemaker](https://github.com/systemed/tilemaker) is a program for creating basemap tilesets from OpenStreetMap, though not ones that match the layers in the Protomaps [Basemap Layers](/basemaps/layers). The PMTiles directories that Tilemakers produces are currently not optimized, which may result in large, slower fetches when decoding in a web browser. An alternative is to create MBTiles from Tilemaker and then use `pmtiles convert`.
+[Tilemaker](https://github.com/systemed/tilemaker) is a program for creating basemap tilesets from OpenStreetMap, though not ones that match the layers in the Protomaps [Basemap Layers](/basemaps/layers). The PMTiles archives that Tilemaker produces are currently not clustered, which may result in large, slower fetches when decoding in a web browser. For production use you should optimize the archive with [pmtiles cluster](/pmtiles/cli#cluster).