Live data from Hacker News

Official NixOS Wiki Launched

wiki.nixos.org

11–13 of 13 posts

Re: Official NixOS Wiki Launched

#11
post #3

https://wiki.nixos.org/wiki/Overview_of_the_Nix_Language > The Nix language is designed for conveniently creating and composing derivations – precise descriptions of how contents of existing files are used to derive new files. I’m getting Wikipedia math vibes.

You've only scratched the surface.

> pkgs.mkShell is a specialized stdenv.mkDerivation that removes some repetition when using it with nix-shell (or nix develop).

https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-mkShell

Re: Official NixOS Wiki Launched

#12

Early days, but it would be nice if the install guides were written out, not just links to videos.

Yes, videos are not good for accessibility, and a lot of people in software don't get on with videos. Same goes for people whose first language is not English.

Re: Official NixOS Wiki Launched

#13
post #8

Earlier quoted context omitted.

IME videos + examples (repo of various configs for many common and less common scenarios) are much more effective (if up to date) than classic guides, specially for on-screen usages, while books are far more effective for the printed world. Producing books demand a significant effort, especially if it's a teaching book, not a mere reference and still cover enough, keeping it up to date in a modern project it's almost…

I often like videos simply because it's impossible to leave out crucial information; everything is shown. Text guides will often skip steps because they assume the reader will know what to do.

Wikis by their very nature allow for people to catch these problems and let people know where there's shortcomings.

As anybody can just hit record on a video and log the entire thing, having a reference video for a process is easy enough, as is turning a video into a transcript automatically that can then be embellished upon. Screenshots can also be taken from videos if there's something visual that may be lost in text.

Post reply on HN