diff --git a/nixos/doc/manual/installation/changing-config.xml b/nixos/doc/manual/installation/changing-config.xml
index b77d71389a9..48193d986ab 100644
--- a/nixos/doc/manual/installation/changing-config.xml
+++ b/nixos/doc/manual/installation/changing-config.xml
@@ -14,6 +14,13 @@
to build the new configuration, make it the default configuration for
booting, and try to realise the configuration in the running system (e.g., by
restarting system services).
+
+
+ This command doesn't start/stop user
+ services automatically. nixos-rebuild only runs a
+ daemon-reload for each user with running user services.
+
+
diff --git a/nixos/doc/manual/man-nixos-rebuild.xml b/nixos/doc/manual/man-nixos-rebuild.xml
index 9cec83f1e28..493b5b9c578 100644
--- a/nixos/doc/manual/man-nixos-rebuild.xml
+++ b/nixos/doc/manual/man-nixos-rebuild.xml
@@ -101,7 +101,8 @@
NixOS module, you must run nixos-rebuild to make the
changes take effect. It builds the new system in
/nix/store, runs its activation script, and stop and
- (re)starts any system services if needed.
+ (re)starts any system services if needed. Please note that user services need
+ to be started manually as they aren't detected by the activation script at the moment.
This command has one required argument, which specifies the desired