From 876a2eba9805a76143347b0dfa5860cfd6bb311e Mon Sep 17 00:00:00 2001
From: Max <max@privatevoid.net>
Date: Wed, 10 Aug 2022 20:44:58 +0200
Subject: [PATCH] packages/stop-using-nix-env: Mention implicit package pinning

Co-authored-by: Fernando Ayats <ayatsfer@gmail.com>
---
 packages/websites/stop-using-nix-env/project.nix    |  2 +-
 packages/websites/stop-using-nix-env/src/index.html | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/packages/websites/stop-using-nix-env/project.nix b/packages/websites/stop-using-nix-env/project.nix
index a148214..2c1439a 100644
--- a/packages/websites/stop-using-nix-env/project.nix
+++ b/packages/websites/stop-using-nix-env/project.nix
@@ -4,7 +4,7 @@
   packages.stop-using-nix-env = let
     site = with pkgs; stdenvNoCC.mkDerivation rec {
       pname = "stop-using-nix-env";
-      version = "1.1.2";
+      version = "1.2.0";
       src = ./src;
       buildCommand = ''
         install -Dm644 $src/* -t $out/share/www/${pname}
diff --git a/packages/websites/stop-using-nix-env/src/index.html b/packages/websites/stop-using-nix-env/src/index.html
index 01b5eaa..3ed212a 100644
--- a/packages/websites/stop-using-nix-env/src/index.html
+++ b/packages/websites/stop-using-nix-env/src/index.html
@@ -178,6 +178,16 @@
     going on a wild goose chase to figure out why your version of
     <x-term>grep</x-term> behaves differently than everyone else's.
   </p>
+  <h2>Implicit package pinning</h2>
+  <p>
+    Packages installed by <x-term>nix-env</x-term> are independent of the NixOS
+    or Home Manager configuration. This can be beneficial because NixOS
+    upgrades will never change what versions of packages a user has installed,
+    however it is a common source of confusion, as a system update
+    ("<x-term>apt upgrade</x-term>") on regular distros will truly upgrade
+    all packages, while on NixOS or when using Home Manager, this is not the
+    case.
+  </p>
   <h2>Informational Video by Matthew Croughan</h2>
   <p>Matthew Croughan demonstrates some of the issues with <x-term>nix-env</x-term>.
   <iframe class="yt" src="https://www.youtube-nocookie.com/embed/hyf4M3eFh2M" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>