Mirrors/nixos-and-flakes-book
2
0
Fork 0
mirror of https://github.com/ryan4yin/nixos-and-flakes-book synced 2024-11-10 06:44:14 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
65 commits 2 branches 32 tags 1.8 MiB
Nix 100%
Find a file
Ryan Yin f8ac62dd4b fix: enable cleanUrls
2023-06-30 15:29:38 +08:00
.github feat: disable github pages 2023-06-23 21:22:07 +08:00
docs fix: enable cleanUrls 2023-06-30 15:29:38 +08:00
.gitignore feat: set up the vitepress development environment and project skeleton 2023-06-23 16:15:31 +08:00
flake.lock feat: set up the vitepress development environment and project skeleton 2023-06-23 16:15:31 +08:00
flake.nix feat: set up the vitepress development environment and project skeleton 2023-06-23 16:15:31 +08:00
LICENSE Initial commit 2023-06-22 23:59:01 -06:00
package.json fix: enable cleanUrls 2023-06-30 15:29:38 +08:00
pnpm-lock.yaml fix: enable cleanUrls 2023-06-30 15:29:38 +08:00
README.md feat: minor changes 2023-06-28 16:39:02 +08:00
vercel.json fix: enable cleanUrls 2023-06-30 15:29:38 +08:00

README.md

NixOS & Flakes Book 🛠️ ❤️

An unofficial and opinionated NixOS & Flakes 📖 for beginners: https://nixos-and-flakes.thiscute.world

中文版: https://nixos-and-flakes.thiscute.world/zh/

TODO

  • Fix spelling and grammatic mistakes in the English version.

Introduction to Flakes

The flakes experimental feature is a major development for Nix, it introduces a policy for managing dependencies between Nix expressions, it improves reproducibility, composability and usability in the Nix ecosystem. Although it's still an experimental feature, flakes have been widely used by the Nix community.1

Flakes is one of the most significant changes the nix project has ever seen.2

Warning about Flakes

The benefits of Flakes are obvious, and the entire NixOS community likes it very much. Currently, more than half of the users are using Flakes3, so we're pretty sure that Flakes will never be deprecated.

⚠️ But Flakes is still an experimental feature, there are still some problems with it, it is likely to introduce some breaking changes in the process of stablizing it, and it’s uncertain how greatly the breaking changes will be.

Overall, I still recommend everyone to use Flakes, this book is also written around NixOS and Flakes after all, but please be prepared for the problems that may be caused by the upcomming breaking changes.

Contribution

A real community, however, exists only when its members interact in a meaningful way that deepens their understanding of each other and leads to learning.

If you find something which doesn't make sense, or something doesn't seem right, please make a pull request and please add valid and well-reasoned explanations about your changes or comments.

Before adding a pull request, please see the contributing guidelines.

Thank you to all the people who already contributed to this project!

License

MIT