about summary refs log tree commit diff
path: root/tools/nixery/docs
diff options
context:
space:
mode:
authorVincent Ambo <tazjin@google.com>2019-08-04T23·27+0100
committerVincent Ambo <github@tazj.in>2019-08-04T23·32+0100
commitd87662b7b562d68561775adeefd29fffb065465c (patch)
tree8c0dd87339e1bb90e430219b21e17f422ed7d304 /tools/nixery/docs
parent6293d69fd94f709d029c5c121956900cad3d24c1 (diff)
docs: Add a section on Nix itself
Diffstat (limited to 'tools/nixery/docs')
-rw-r--r--tools/nixery/docs/src/nix.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/tools/nixery/docs/src/nix.md b/tools/nixery/docs/src/nix.md
new file mode 100644
index 000000000000..2bfd75a6925c
--- /dev/null
+++ b/tools/nixery/docs/src/nix.md
@@ -0,0 +1,31 @@
+# Nix
+
+These sections are designed to give some background information on what Nix is.
+If you've never heard of Nix before looking at Nixery, this might just be the
+page for you!
+
+[Nix][] is a functional package-manager that comes with a number of advantages
+over traditional package managers, such as side-by-side installs of different
+package versions, atomic updates, easy customisability, simple binary caching
+and much more. Feel free to explore the [Nix website][Nix] for an overview of
+Nix itself.
+
+Nix uses a custom programming language also called Nix, which is explained here
+[on its own page][nix-1p].
+
+In addition to the package manager and language, the Nix project also maintains
+[NixOS][] - a Linux distribution built entirely on Nix. On NixOS, users can
+declaratively describe the *entire* configuration of their system and perform
+updates/rollbacks to other system configurations with ease.
+
+Most Nix packages are tracked in the [Nix package set][nixpkgs], usually simply
+referred to as `nixpkgs`. It contains tens of thousands of packages already!
+
+Nixery (which you are looking at!) provides an easy & simple way to get started
+with Nix, in fact you don't even need to know that you're using Nix to make use
+of Nixery.
+
+[Nix]: https://nixos.org/nix/
+[nix-1p]: nix-1p.html
+[NixOS]: https://nixos.org/
+[nixpkgs]: https://github.com/nixos/nixpkgs