From 8476b02749ac97b49629745ded7b8b333c8d024a Mon Sep 17 00:00:00 2001
From: Maximilian Bosch <maximilian@mbosch.me>
Date: Fri, 9 Dec 2022 11:34:05 +0100
Subject: [PATCH] nixos/doc: suggest using the latest longterm kernel for ZFS

---
 .../doc/manual/configuration/linux-kernel.chapter.md |  5 ++++-
 .../from_md/configuration/linux-kernel.chapter.xml   | 12 +++++++++---
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/nixos/doc/manual/configuration/linux-kernel.chapter.md b/nixos/doc/manual/configuration/linux-kernel.chapter.md
index 87c1cf6a7cb8..7b84416a8646 100644
--- a/nixos/doc/manual/configuration/linux-kernel.chapter.md
+++ b/nixos/doc/manual/configuration/linux-kernel.chapter.md
@@ -152,7 +152,10 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module
 ## ZFS {#sec-linux-zfs}
 
 It's a common issue that the latest stable version of ZFS doesn't support the latest
-available Linux kernel. It's possible to pin the system to the latest available kernel
+available Linux kernel. It is recommended to use the latest available LTS that's compatible
+with ZFS. Usually this is the default kernel provided by nixpkgs (i.e. `pkgs.linuxPackages`).
+
+Alternatively, it's possible to pin the system to the latest available kernel
 version *that is supported by ZFS* like this:
 
 ```nix
diff --git a/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml b/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml
index 7fb3ba5ac98f..dd570e1d66c2 100644
--- a/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml
+++ b/nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml
@@ -171,9 +171,15 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module
     <title>ZFS</title>
     <para>
       It’s a common issue that the latest stable version of ZFS doesn’t
-      support the latest available Linux kernel. It’s possible to pin
-      the system to the latest available kernel version <emphasis>that
-      is supported by ZFS</emphasis> like this:
+      support the latest available Linux kernel. It is recommended to
+      use the latest available LTS that’s compatible with ZFS. Usually
+      this is the default kernel provided by nixpkgs (i.e.
+      <literal>pkgs.linuxPackages</literal>).
+    </para>
+    <para>
+      Alternatively, it’s possible to pin the system to the latest
+      available kernel version <emphasis>that is supported by
+      ZFS</emphasis> like this:
     </para>
     <programlisting language="bash">
 {