nixos-config/docs/content/en-US/introduction/index.adoc

1.6 KiB
Raw Blame History


title: Introduction --- = Introduction

Hey there, fellow traveler! Youve fell into the rabbit hole we call Nix where it leads to other rabbit holes such as functional package management, reproducibility, declarative systems, and immutable operating systems.

Legends say the rabbit hole runs so deep youll eventually spend hours to create a dedicated website only for your NixOS configuration. However, I havent seen this for myself nor I see much examples of it. But it is just mere legend anyways for a radically different package management, operating system, and deployment method, so who cares really.

Anyways… What youre seeing right now is the documentation for my NixOS configuration as a Nix flake. It eventually evolves as a massive blob of abomination that will surely get simpler as time go by.

Why would you have an entire book on just your NixOS configuration? This seems like overkill.

Because it is overkill and thats what were going for.

And what is this book made of? Hugo? With Asciidoctor? With a customized version of github:foo-dogsquared/hugo-theme-more-contentful[your own theme]? Of all options!?! Why?

Why not use something like github:rust-lang/mdBook[mdBook]? Or mkdocs-material that makes things eas-

You know what, Im not going to continue with this. I think I know why.