From 8b14679c0e1570b0e137f0f7997717be0fdf2cf2 Mon Sep 17 00:00:00 2001
From: 0xda157 <da157@voidq.com>
Date: Fri, 30 Jan 2026 16:39:54 -0800
Subject: [PATCH] doc/src/installation: note master branch follows
 rolling-release model  (#2116)

Link: https://github.com/nix-community/stylix/pull/2116

Co-authored-by: NAHO <90870942+trueNAHO@users.noreply.github.com>
---
 doc/src/installation.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/src/installation.md b/doc/src/installation.md
index d86b9171..7e5285e7 100644
--- a/doc/src/installation.md
+++ b/doc/src/installation.md
@@ -1,5 +1,15 @@
 # Installation
 
+> [!IMPORTANT]
+> The master (unstable) branch of Stylix follows a rolling-release model. To
+> ensure version compatibility, all inputs must be kept in sync.
+>
+> Avoid partial updates and always update inputs together with:
+>
+> ```console
+> nix flake update
+> ```
+
 ## NixOS
 
 You can install Stylix into your NixOS configuration using [Flakes][nix-flakes].