Structural: Start the language section earlier

[hsjobeki]

Could it be possible to improve the structure of the documentation. As a reader it is not obvious how to start and what topics are needed to learn first.

I suggest the following structure:

0. short! Introduction
1. nix language (it is necessary)
2. nix principles ….
3. …

Thanks in advance

[jtojnar]

As mentioned in the preface, the pills originated as a series of blog posts and are meant to be read in order.

I would say that the language description already starts as soon as possible (pills 4 & 5):

• Pill 1 is an introduction + principles.
• Pill 2 is how to get Nix on your system, which you will need for playing with the language.
• Pill 3 is what you will need to know for working with packages/derivations. And since Nix pills introduce Nix through building derivations from scratch, that is necessary too.

I guess it would be possible to move pill 3 after pill 5, since they are largely independent but I think having a chapter where the reader can do something in between learning-heavy chapters is beneficial.