diff --git a/docs/guides/configuration-guide/ceph.md b/docs/guides/configuration-guide/ceph.md
index 119d3dde7e..fc92487b1a 100644
--- a/docs/guides/configuration-guide/ceph.md
+++ b/docs/guides/configuration-guide/ceph.md
@@ -126,12 +126,14 @@ pools are to be created is `ceph.rbd`, then the parameters would be stored in
 | openstack_pool_default_pg_num   | 64            |
 | openstack_pool_default_min_size | 0             |
 
-## OSD Devices
+## Devices
 
 ```yaml
 ceph_osd_db_wal_devices_buffer_space_percent: 10
 ```
 
+### Dedicated DB devices
+
 ```yaml
 ceph_db_devices:
   nvme0n1:         # required, PV for a DB VG
@@ -143,6 +145,8 @@ ceph_db_devices:
                    # (VG size - buffer space (if enabled)) / num_osds
 ```
 
+### Dedicated WAL devices
+
 ```yaml
 ceph_wal_devices:
   nvme1n1:         # See above, PV for a WAL VG
@@ -150,6 +154,8 @@ ceph_wal_devices:
     wal_size: 2 GB # optional, if not set, defaults to 2 GiB
 ```
 
+### Shared DB & WAL devices
+
 ```yaml
 ceph_db_wal_devices:
   nvme2n1:         # See above, PV for combined WAL+DB VG
@@ -159,24 +165,42 @@ ceph_db_wal_devices:
     wal_size: 2 GB # See above
 ```
 
+### OSD devices
+
 ```yaml
 ceph_osd_devices:
   sda:              # Device name, will be prefixed by /dev/, see above conventions
                     # This would create a "block only" OSD without DB/WAL
-  sdb:              # Create an OSD with dedicated DB
+```
+
+```yaml
+ceph_osd_devices:
+  sda:              # Create an OSD with dedicated DB
     db_pv: nvme0n1  # Must be one device configured in ceph_db_devices
                     # or ceph_db_wal_devices
-  sdc:              # Create an OSD with dedicated WAL
+```
+
+```yaml
+ceph_osd_devices:
+  sda:              # Create an OSD with dedicated WAL
     wal_pv: nvme1n1 # Must be one device configured in ceph_wal_devices
                     # or ceph_db_wal_devices
-  sdb:              # Create an OSD with dedicated DB/WAL residing on different devices
+
+```yaml
+ceph_osd_devices:
+  sda:              # Create an OSD with dedicated DB/WAL residing on different devices
     db_pv: nvme0n1  # See above
     wal_pv: nvme1n1 # See above
-  sdc:              # Create an OSD with dedicated DB/WAL residing on the same VG/PV
+
+```yaml
+ceph_osd_devices:
+  sda:              # Create an OSD with dedicated DB/WAL residing on the same VG/PV
     db_pv: nvme2n1  # Must be one device configured in ceph_db_wal_devices
     wal_pv: nvme2n1 # Must be the same device configured in ceph_db_wal_devices
 ```
 
+### Preparation
+
 1. Provide config stanza like above either in `group_vars` or `host_vars`
    in the inventory of the configuration repository
 2. Do `osism reconciler sync` and `osism apply facts`