From 90a67cbe631b1fb6bb9da97e8a799426bba0a42b Mon Sep 17 00:00:00 2001
From: Abhishek <50703483+Abhishek-1804@users.noreply.github.com>
Date: Thu, 26 Dec 2024 11:23:40 -0700
Subject: [PATCH] darwin-rebuild: add page, home-manager: edit page (#15175)

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
---
 pages/common/home-manager.md | 20 ++++++++++++++++----
 pages/osx/darwin-rebuild.md  | 16 ++++++++++++++++
 2 files changed, 32 insertions(+), 4 deletions(-)
 create mode 100644 pages/osx/darwin-rebuild.md

diff --git a/pages/common/home-manager.md b/pages/common/home-manager.md
index 47d51e7b4..37529c093 100644
--- a/pages/common/home-manager.md
+++ b/pages/common/home-manager.md
@@ -1,12 +1,24 @@
 # home-manager
 
-> Manage a user environment using Nix.
-> More information: <https://github.com/rycee/home-manager>.
+> Manage a per-user environment using Nix, allowing declarative configuration of the user’s home.
+> More information: <https://github.com/nix-community/home-manager>.
 
-- Activate the configuration defined in `~/.config/nixpkgs/home.nix`:
+- Build the configuration defined in `~/.config/nixpkgs/home.nix` without applying it:
 
 `home-manager build`
 
-- Activate the configuration and switch to it:
+- Build and apply (switch to) the new configuration:
 
 `home-manager switch`
+
+- Build the configuration for testing without applying it:
+
+`home-manager test`
+
+- Roll back to a previous configuration generation:
+
+`home-manager rollback`
+
+- List all existing configuration generations:
+
+`home-manager generations`
diff --git a/pages/osx/darwin-rebuild.md b/pages/osx/darwin-rebuild.md
new file mode 100644
index 000000000..72b7a4093
--- /dev/null
+++ b/pages/osx/darwin-rebuild.md
@@ -0,0 +1,16 @@
+# darwin-rebuild
+
+> Rebuild and switch to a Nix-based Darwin (macOS) system configuration.
+> More information: <https://github.com/LnL7/nix-darwin>.
+
+- Rebuild and switch to the specified Darwin configuration:
+
+`darwin-rebuild switch --flake {{path/to/flake}}`
+
+- Build the configuration but don't switch to it:
+
+`darwin-rebuild build --flake {{path/to/flake}}`
+
+- Display help:
+
+`darwin-rebuild --help`