News for hackers. Stuff that matters.
Re:Official NixOS Wiki Launched by chiffre01 on Thursday April 11, 2024 @09:20AM (#40001829)
Early days, but it would be nice if the install guides were written out, not just links to videos.
Re:Official NixOS Wiki Launched by kkfx on Thursday April 11, 2024 @11:02AM (#40002946)
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 a nightmare, so videos and examples remain the quickest and easiest solution.

Personally the main issue I have with NixOS is:

- the Nix language, especially compared to Guix System

- the lack of quickly digestible AND still deep enough docs

I've using NixOS as my main desktop and homeserver since some years and I still have to know Nix enough to be really "confident enough"...

Re:Official NixOS Wiki Launched by Asraelite on Thursday April 11, 2024 @03:12PM (#40005711)
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.

Re:Official NixOS Wiki Launched by hammyhavoc on Saturday April 13, 2024 @10:09AM (#40023259)
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.

Re:Official NixOS Wiki Launched by hammyhavoc on Saturday April 13, 2024 @10:08AM (#40023247)
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.