2023-05-11 - Learning Journey Working Group - Meeting Notes #8

[alper]

@fricklerhandwerk

while that type of work you did on Nix Shorts goes in the right direction, it neither satisfies your own didactic criteria (as it’s talking about attributes and other concepts that were not introduced beforehand) nor is it correct or precise enough to be acceptable as authoritative documentation (I see more issues than I can dump here), and most importantly it’s targeted at a third-party resource (which means it won’t be reviewed or kept up to date by Nix maintainers)

I mean I’ll admit that it is not great and could be improved a lot, but I didn’t want that to discourage me so I spent time forking and overhauling the entire set of shorts.

Just to put my time where my mouth is (and it took quite some more time than I expected):

Nix Shorts overhauled and updated

I’ve forked and updated the nix shorts. I hope like I this they can be a good resource for people who are new to the nix ecosystem. Reading all the documentation I could find around the web, it felt to me that the shorts collection format and level are good, just that the content was too outdated to be useful. I’ve tried to fix that here. I’ve rewritten it a lot, updated it to use flakes where it makes sense and removed some stuff which I don’t feel is very useful or relevant for beginners. …

If I get some (any?) positive feedback, I’ll continue pushing on this. If nothing else, it’s been a good way to capture and formalize my learning journey and structure the various bits and pieces I came across.