From 1e9c1e775f76f0b4b65da1ed2c69d24cf0da6834 Mon Sep 17 00:00:00 2001 From: Irene Knapp Date: Sat, 15 Jun 2024 13:31:19 -0700 Subject: [PATCH] add a note to the top of the resources page about outdated practices --- content/resources.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/content/resources.md b/content/resources.md index a9c1d5d0..7cd77532 100644 --- a/content/resources.md +++ b/content/resources.md @@ -12,6 +12,15 @@ of the community. We're also currently in the process of writing brand new documentation, which will be listed here once available. +## A note of caution + +Nix has a long history. Some things that seemed like good ideas once are no longer common practice. In particular: + +- It's probably a good idea to ignore `nix-env` and mutable environments in favor of declarative configuration +- If you don't already use channels, it's probably a good idea to learn about flakes or some other pinning mechanism instead + +If you're learning about those topics because you want to understand the ideas that are currently in favor in the historical contexts they are responses to, or because you think you see a benefit to them that others don't, that's totally fine; this warning is only here to help beginners have a fruitful experience. + ## Understanding Nix - [The official Nix ecosystem documentation](https://nix.dev), maintained by the **NixOS Foundation**.