diff --git a/basemaps/layers.md b/basemaps/layers.md
index 3fc63c3..7267585 100644
--- a/basemaps/layers.md
+++ b/basemaps/layers.md
@@ -395,7 +395,9 @@ This layer is currently empty.
 
 <MaplibreMap highlightLayer="water" :zoom=6 :showZoom="true" :lat="-1.3" :lng="-49"/>
 
-Polygons from the Natural Earth 50m `lakes` and `ocean` themes for z0-z4, 10m for z5, preprocessed land polygons from [OSMCoastline](https://osmdata.openstreetmap.de) for z6+.
+* Polygons, lines and point labels from OpenStreetMap.
+
+* Polygons from the Natural Earth 50m `lakes` and `ocean` themes for z0-z4, 10m for z5, preprocessed land polygons from [OSMCoastline](https://osmdata.openstreetmap.de) for z6+.
 
 | Key            |                                             Values                                              | Description |
 | -------------- | :---------------------------------------------------------------------------------------------: | ----------: |
diff --git a/pmtiles/create.md b/pmtiles/create.md
index 6c0b45e..f2ab84f 100644
--- a/pmtiles/create.md
+++ b/pmtiles/create.md
@@ -42,10 +42,19 @@ gdal_translate -expand rgb input.tif input_rgb.tif
 
 pip install rio-pmtiles
 
-# in this example create 512x512 PNG tiles from zooms 0 to 16.
-rio pmtiles input_rgb.tif output.pmtiles --format PNG --zoom-levels 0..16 --tile-size 512 --resampling bilinear
+rio pmtiles input_rgb.tif output.pmtiles --format PNG --resampling bilinear
 ```
 
+Options:
+
+* `--format`: One of `PNG` (lossless), `JPEG`, `WEBP`. `JPEG` is fastest to generate. Default `WEBP`.
+* `--tile-size`: the dimensions in pixels. 512 is recommended for displaying in MapLibre GL. default `512`.
+* `--resampling`: Choose `nearest` for discrete data. Default `bilinear`.
+* `--silent`: Don't show a progress bar.
+* `--zoom-levels`: Specify a range `10..12` to only generate those zoom levels. By default, generates all levels between 0 and the level to capture the full detail of the input.
+* `--help`: Show other advanced options and GDAL flags.
+
+
 ## GDAL
 
 GDAL has native support for PMTiles starting with version 3.8.0 (2023-11-13), see [gdal.org/drivers/vector/pmtiles](https://gdal.org/drivers/vector/pmtiles.html) for details.