From f600858902623066c8f1047fa88b7e7c5d6f3bdd Mon Sep 17 00:00:00 2001 From: Ryan Yin Date: Sun, 4 Feb 2024 17:42:45 +0800 Subject: [PATCH] fix: style --- docs/preface.md | 6 +++++- docs/zh/preface.md | 1 + 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/preface.md b/docs/preface.md index 924cf23..e948d40 100644 --- a/docs/preface.md +++ b/docs/preface.md @@ -8,7 +8,11 @@ One of NixOS's major advantages over other distributions lies in its reproducibi While NixOS is powerful, its strength also comes with increased system complexity. This makes it more challenging for newcomers. One major challenge is that the knowledge accumulated on other Linux distributions is not easily transferable to NixOS. Another is that official and community documentation is often scattered and outdated. These issues have troubled many NixOS beginners. -One can observe these issues with the experimental feature of the Nix package manager called Flakes. Inspired by package managers like npm and Cargo, Flakes uses `flake.nix` to record all external dependencies and `flake.lock` to lock their versions. This significantly enhances the reproducibility and composability of the Nix package manager and NixOS configurations. Flakes' advantages have made it widely popular within the community: according to official surveys, over half of the new Nix repositories created on GitHub now utilize Flakes. However, to maintain stability, the official documentation covers barely any Flakes-related content. This has left many Nix/NixOS users feeling confused. They see everyone using Flakes and want to learn it too, but find nowhere to start, often having to piece together scattered information, search through Nixpkgs source code, or seek help from more experienced users. +One can observe these issues with the experimental feature of the Nix package manager called Flakes. Inspired by package managers like npm and Cargo, Flakes uses `flake.nix` to record all external dependencies and `flake.lock` to lock their versions. This significantly enhances the reproducibility and composability of the Nix package manager and NixOS configurations. + +Flakes' advantages have made it widely popular within the community: according to official surveys, over half of the new Nix repositories created on GitHub now utilize Flakes. + +However, to maintain stability, the official documentation covers barely any Flakes-related content. This has left many Nix/NixOS users feeling confused. They see everyone using Flakes and want to learn it too, but find nowhere to start, often having to piece together scattered information, search through Nixpkgs source code, or seek help from more experienced users. ## The Origin of This Book diff --git a/docs/zh/preface.md b/docs/zh/preface.md index 29b449c..aa61af1 100644 --- a/docs/zh/preface.md +++ b/docs/zh/preface.md @@ -11,6 +11,7 @@ NixOS 很强大，但它的强大也带来了系统复杂度的提升，提高 这些问题都困扰着许多 NixOS 新手。 再说到 Nix 包管理器的实验特性 Flakes，它借鉴了 npm/cargo 等包管理器的设计思路，使用 flake.nix 记录所有外部依赖项，使用 flake.lock 锁定所有依赖的版本，极大地增强了 Nix 包管理器及 NixOS 的可复现能力跟配置可组合能力。 + 因为 Flakes 的好处很大，社区非常喜欢它。据官方调查，目前 GitHub 新建的 nix 仓库超过半数都使用了 Flakes，传统的 Nix 配置方式已经不再是主流。 但是另一方面 Flakes 作为一个实验性能力存在不确定性，官方文档为了保持稳定性，几乎未包含任何 Flakes 相关的内容。