Root on ZFS: warning for GRUB incompatibility with bpool snapshots

docs/Getting Started/Alpine Linux/Root on ZFS.rst

@@ -28,6 +28,22 @@ Alpine Linux Root on ZFS
 Unless stated otherwise, it is not recommended to customize system
 configuration before reboot.
 
+**No snapshot of bpool**
+
+#. Do not take recursive snapshot of any dataset in bpool.
+#. Do not take snapshot of the "bpool" dataset.
+
+GRUB failure has been reported when such snapshots were taken. This
+can only be fixed by re-creating the pool.  See `issue report
+<https://github.com/openzfs/zfs/issues/13873>`__.
+
+However, you can take non-recursive snapshots of any child dataset of
+bpool.  Such as
+
+.. code-block:: sh
+
+    zfs snapshot bpool/distro/root@non-recursive-snap
+
 Preparation
 ---------------------------
 

docs/Getting Started/Arch Linux/Root on ZFS.rst

@@ -32,6 +32,22 @@ Arch Linux Root on ZFS
 Unless stated otherwise, it is not recommended to customize system
 configuration before reboot.
 
+**No snapshot of bpool**
+
+#. Do not take recursive snapshot of any dataset in bpool.
+#. Do not take snapshot of the "bpool" dataset.
+
+GRUB failure has been reported when such snapshots were taken. This
+can only be fixed by re-creating the pool.  See `issue report
+<https://github.com/openzfs/zfs/issues/13873>`__.
+
+However, you can take non-recursive snapshots of any child dataset of
+bpool.  Such as
+
+.. code-block:: sh
+
+    zfs snapshot bpool/distro/root@non-recursive-snap
+
 Preparation
 ---------------------------
 

docs/Getting Started/Fedora/Root on ZFS.rst

@@ -33,6 +33,22 @@ Fedora Root on ZFS
 Unless stated otherwise, it is not recommended to customize system
 configuration before reboot.
 
+**No snapshot of bpool**
+
+#. Do not take recursive snapshot of any dataset in bpool.
+#. Do not take snapshot of the "bpool" dataset.
+
+GRUB failure has been reported when such snapshots were taken. This
+can only be fixed by re-creating the pool.  See `issue report
+<https://github.com/openzfs/zfs/issues/13873>`__.
+
+However, you can take non-recursive snapshots of any child dataset of
+bpool.  Such as
+
+.. code-block:: sh
+
+    zfs snapshot bpool/distro/root@non-recursive-snap
+
 Preparation
 ---------------------------
 

docs/Getting Started/NixOS/Root on ZFS.rst

@@ -29,6 +29,23 @@ Immutable root can be enabled or disabled by setting
 Unless stated otherwise, it is not recommended to customize system
 configuration before reboot.
 
+**No snapshot of bpool**
+
+#. Do not take recursive snapshot of any dataset in bpool.
+#. Do not take snapshot of the "bpool" dataset.
+
+GRUB failure has been reported when such snapshots were taken. This
+can only be fixed by re-creating the pool.  See `issue report
+<https://github.com/openzfs/zfs/issues/13873>`__.
+
+However, you can take non-recursive snapshots of any child dataset of
+bpool.  Such as
+
+.. code-block:: sh
+
+    zfs snapshot bpool/distro/root@non-recursive-snap
+
+
 Preparation
 ---------------------------
 

docs/Getting Started/RHEL-based distro/Root on ZFS.rst

@@ -30,6 +30,22 @@ Rocky Linux Root on ZFS
 Unless stated otherwise, it is not recommended to customize system
 configuration before reboot.
 
+**No snapshot of bpool**
+
+#. Do not take recursive snapshot of any dataset in bpool.
+#. Do not take snapshot of the "bpool" dataset.
+
+GRUB failure has been reported when such snapshots were taken. This
+can only be fixed by re-creating the pool.  See `issue report
+<https://github.com/openzfs/zfs/issues/13873>`__.
+
+However, you can take non-recursive snapshots of any child dataset of
+bpool.  Such as
+
+.. code-block:: sh
+
+    zfs snapshot bpool/distro/root@non-recursive-snap
+
 Preparation
 ---------------------------