-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: Edit chapters: ch00-00, ch01-00, ch02-00
Common edits: - Replace "nix" with "Nix" - Replace "it's" with "its" - Remove whitespace at line endings ch00-00: - Split lines to avoid linebreaks leaving single words after the linebreak. ch01-00: - Active form (trying -> who try) - Move "The motivation" sentence ahead of "The goal" sentence. - Right-align signature and use ndash instead of "--" ch02-00: - Avoid "which ... which ..." - Emphasise "derivation" with italics - Replace "aggregated" with "hashed": Avoid repetition of "aggregated", simpler - Move FHS wiki link to reference, so it can be reused in "non-FHS" - Extend "Teams of Developers" section: Also mention build environments, mention lower onboarding time. - intended -> intend - Extend "Power Users" section with the argument that you can persist configuration across multiple machines. - Nix Language section: "+ imports" - truely -> truly, entirity -> entirety, OS's -> OS'es - re-capitalised DAG as "*directed, acyclic graph*"
- Loading branch information
Showing
3 changed files
with
66 additions
and
56 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,22 +1,20 @@ | ||
# Preface | ||
|
||
My journey to learn nix was only possible by my extreme desire to master it. | ||
My journey to learn Nix was only made possible by my extreme desire to master it. | ||
The path was anything but easy and predictable. And it is still a considerable | ||
hurdle for many trying to learn nix. | ||
hurdle for many who try to learn Nix. | ||
|
||
The goal of this book is to provide newcomers with a more approachable | ||
document than the [nix-pills series](https://nixos.org/guides/nix-pills). | ||
Although nix-pills is still a very good resource | ||
Although nix-pills is a very good resource | ||
with many years of refinement, it is extensive and hard to follow without | ||
some prior knowledge of nix. This book hopes to | ||
provide a more recent account of nix with more of a focus on giving the user | ||
intuition around what nix is doing rather than a deep understanding like nix-pills. | ||
some prior knowledge of Nix. This book hopes to | ||
provide a more recent account of Nix with more of a focus on giving the user | ||
intuition around what Nix is doing rather than a deep understanding like nix-pills. | ||
|
||
The goal is not to replace any existing nix guides or documentation, but rather | ||
provide a good starting place for new users. Motivation for writing | ||
this is to provide a "nix equilavent of the [rust-lang book](https://doc.rust-lang.org/book/)". | ||
Where there is one resource which can be read end-to-end in an afternoon and | ||
able to equip the reader with the knowledge necessary | ||
to thrive in the nix ecosystem. | ||
The motivation for writing this is to provide a "Nix equivalent of the [rust-lang book](https://doc.rust-lang.org/book/)": | ||
one resource that can be read end-to-end in an afternoon that is able to equip the reader with the | ||
knowledge necessary to thrive in the Nix ecosystem. The goal is not to replace any existing Nix | ||
guides or documentation, but rather provide a good starting place for new users. | ||
|
||
-- Jonathan Ringer | ||
<div style="text-align: right">– Jonathan Ringer</div> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters