diff --git a/nixos/doc/manual/release-notes/rl-2311.section.md b/nixos/doc/manual/release-notes/rl-2311.section.md
index d2dece0be4d4..78e02c9d2446 100644
--- a/nixos/doc/manual/release-notes/rl-2311.section.md
+++ b/nixos/doc/manual/release-notes/rl-2311.section.md
@@ -1313,7 +1313,7 @@ Make sure to also check the many updates in the [Nixpkgs library](#sec-release-2
   qemu-vm module from overriding `fileSystems` by setting
   `virtualisation.fileSystems = lib.mkForce { };`.
 
-## Nixpkgs Library Changes {#sec-release-23.11-nixpkgs-lib}
+## Nixpkgs Library {#sec-release-23.11-nixpkgs-lib}
 
 ### Breaking Changes {#sec-release-23.11-lib-breaking}
 
@@ -1346,8 +1346,10 @@ Make sure to also check the many updates in the [Nixpkgs library](#sec-release-2
   [GVariant Format
   Strings](https://docs.gtk.org/glib/gvariant-format-strings.html) for details.
 
-  :::{.warning} This API is not considered fully stable and it might therefore
-  change in backwards incompatible ways without prior notice. :::
+  :::{.warning}
+  This API is not considered fully stable and it might therefore
+  change in backwards incompatible ways without prior notice.
+  :::
 
 - [`lib.asserts`](https://nixos.org/manual/nixpkgs/unstable#sec-functions-library-asserts):
   New function:
@@ -1405,12 +1407,18 @@ Make sure to also check the many updates in the [Nixpkgs library](#sec-release-2
 
 Module system:
 - Options in the `options` module argument now have the `declarationPositions`
-  attribute containing the position where the option was declared: ``` $ nix
-  repl -f '<nixpkgs/nixos>' [...] nix-repl> :p
-  options.environment.systemPackages.declarationPositions [ { column = 7; file =
-  "/nix/store/vm9zf9wvfd628cchj0hdij1g4hzjrcz9-source/nixos/modules/config/system-path.nix";
-  line = 62; } ] ``` Not to be confused with `definitionsWithLocations`, which
-  is the same but for option _definitions_.
+  attribute containing the position where the option was declared:
+  ```
+  $ nix-repl -f '<nixpkgs/nixos>' [...]
+  nix-repl> :p options.environment.systemPackages.declarationPositions
+  [ {
+    column = 7;
+    file = "/nix/store/vm9zf9wvfd628cchj0hdij1g4hzjrcz9-source/nixos/modules/config/system-path.nix";
+    line = 62;
+  } ]
+  ```
+
+  Not to be confused with `definitionsWithLocations`, which is the same but for option _definitions_.
 - Improved error message for option declarations missing `mkOption`
 
 ### Deprecations {#sec-release-23.11-lib-deprecations}