Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Nix pills links to the github repo are outdated #148

Open
kototama opened this issue Jun 12, 2020 · 0 comments
Open

Nix pills links to the github repo are outdated #148

kototama opened this issue Jun 12, 2020 · 0 comments

Comments

@kototama
Copy link

In the Nix Pills, the nixpkgs github repository code is linked multiple times for pedagogic reasons. For example when introducing the concept of a fixed point in paragraph 17.3. The problem is that the links are using the master branch. Since the nix pills have been written, the code in master has changed and the links do not point to the original concepts anymore. This makes it harder for newcomers to follow the Nix Pills introductions [1]

I would suggest pinning the links to the latest git commit (or multiple, if not possible) that still contain the concept. It would make the whole less confusing.









[1] which are already not always clear, for example try to make sense of this sentence:

For example, config.allowUnfree is an attribute that forbids building packages that have an unfree license by default.

It's not helpful to describe an attribute named allowUnfree with a negative term ("forbids"). Also grammatically it's not 100% clear to what the "by default" refers to. But ok that's a topic for a different issue...

@garbas garbas transferred this issue from NixOS/nixos-homepage Jun 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant