diff --git a/modules/services/window-managers/i3.nix b/modules/services/window-managers/i3.nix
index 535889df7..4a356328b 100644
--- a/modules/services/window-managers/i3.nix
+++ b/modules/services/window-managers/i3.nix
@@ -34,9 +34,9 @@ let
         type = types.nullOr types.string;
         default = null;
         description = ''
-          Launch application on a particular workspace.
-          DEPRECATED: Use i3.config.assigns instead.
-          See https://github.com/rycee/home-manager/issues/265.
+          Launch application on a particular workspace. DEPRECATED:
+          Use <varname><link linkend="opt-xsession.windowManager.i3.config.assigns">xsession.windowManager.i3.config.assigns</link></varname>
+          instead. See <link xlink:href="https://github.com/rycee/home-manager/issues/265"/>.
         '';
       };
     };