From 85e4e16de8690eedd136c59900771991e77951ee Mon Sep 17 00:00:00 2001
From: Matt Sturgeon <matt@sturgeon.me.uk>
Date: Sun, 19 Jan 2025 13:23:14 +0000
Subject: [PATCH] docs: notify `useGlobalPackages` breaking change

---
 docs/mdbook/index.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/mdbook/index.md b/docs/mdbook/index.md
index d42fa5f7..68413126 100644
--- a/docs/mdbook/index.md
+++ b/docs/mdbook/index.md
@@ -8,6 +8,14 @@ Documentation is currently available for the following versions:
 
 @DOCS_VERSIONS@
 
+## Recent Breaking Changes
+
+> [!CAUTION]
+> By default, Nixvim now constructs its own instance of nixpkgs, using the revision from our flake.lock.
+> This change was largely motivated by: [How do I solve "`<name>` cannot be found in `pkgs`"](./user-guide/faq.html#how-do-i-solve-name-cannot-be-found-in-pkgs)
+>
+> The old behaviour can be restored by enabling `nixpkgs.useGlobalPackages`.
+
 ## What is it?
 NixVim is a [Neovim](https://neovim.io) distribution built around
 [Nix](https://nixos.org) modules. It is distributed as a Nix flake, and