Nix Documentation | 416 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 88 Servers |
| Sender | Message | Time |
|---|---|---|
| 9 Apr 2024 | ||
| 23:22:58 | ||
| 10 Apr 2024 | ||
| Hey there, while attending a tech_meetup, during a discussion about operating systems . . . I mentioned that I recently installed NixOS and am getting to like it . . . as a result I was talked into giving a presentation about NixOS at the next meetup. I agreed to do a guided installation demo where participants would install and setup Nix on their machines. It looks like I am going to become a tutor . . . and in that roll I figure it would be wise for me to sift through all the documentation I can find. Obsidian seems like a useful tool to journal and make notes with, which is been helpful to get organized to try an teach a subject I know little about. Any advice? | 05:03:43 | |
In reply to @technicus:matrix.org I'd just say, you don't need to be an expert on the whole OS to explain what you like about it and walk people through the install! In other words, don't try to scope your tutorial too broadly. That breadth of knowledge will come in time, and only with time, so I suggest focusing on the desktop installation and first steps. You can only cover a little bit in a single talk and have the knowledge still be absorbable. Declarative system management is a new idea for a lot of people, so I suggest talking a little about how installing stuff with a config file differs from how it's done on more "traditional" distros, or windows or whatever. Demo the process of searching for a package on search.nixos.org (like https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=discord) and installing the program via For stuff related to the basic installation, this wiki page might be a good place to start: https://wiki.nixos.org/wiki/NixOS_as_a_desktop | 05:19:53 | |
In reply to @technicus:matrix.org* I'd just say, you don't need to be an expert on the whole OS to explain what you like about it and walk people through the install! In other words, don't try to scope your tutorial too broadly. That breadth of knowledge will come in time, and only with time, so I suggest focusing on the desktop installation and first steps. You can only cover a little bit in a single talk and have the knowledge still be absorbable. Also, practice will help a lot if you want to be more confident when presenting. Declarative system management is a new idea for a lot of people, so I suggest talking a little about how installing stuff with a config file differs from how it's done on more "traditional" distros, or windows or whatever. Demo the process of searching for a package on search.nixos.org (like https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=discord) and installing the program via For stuff related to the basic installation, this wiki page might be a good place to start: https://wiki.nixos.org/wiki/NixOS_as_a_desktop | 05:22:43 | |
| Bottom line: covering only a small amount of material is a good idea for this sort of context. | 05:23:33 | |
In reply to @fractivore:cyberia.club Thanks for the advice! We have two hours, I figure setting up the demo and guiding people through the install could go on for about an hour (pending technical challenges). Then we could chat and I could respond with questions. After, maybe do some one on one assistance. It is a small group, between five and ten people, and most all have relatable experience with GNU/Libre/Linux software. | 05:30:22 | |
| A couple of friends of mine asked me if I could tutor their kids. I am going to try crafting a progressive lesson series. Maybe once or twice a month, meet with them and help with what they want to know or might have difficulty with, and when they are ready or as needed develop new lessons and tutorials to help them out. So I figure to avoid being stumped when they ask me questions, I should get to know all that I can for myself. | 05:38:14 | |
| The one question that was asked which inspired me to start studying was about the pillars of Reproduciblity, Declarativity and Immutability. I was a little stumped when trying to explain the concepts, and the next time I get asked . . . it would be great if I could reply with definitive concise explanations and provide examples. | 05:52:41 | |
In reply to @technicus:matrix.orgIt's great to try to avoid getting stumped, but like, sometimes even professors teaching the same class for 20 years will get stumped by a student's question. That's what makes teaching such a great way to learn, the new perspectives that one can't anticipate on one's own! Don't be afraid to admit when you aren't sure about something - it can be a great way to model a good learning attitude, as well as a demonstration of how to get more information on something you're not sure about. Don't be afraid to look stuff up, live, and figure it out alongside your peers. | 06:29:07 | |
In reply to @technicus:matrix.orgLike, about the definitions of those terms? | 06:29:30 | |
| Miles Dyson: for the case you like to focus on using nixos on desktops ... starting from nix and using it to create nixos-vms and then edit the configuration can be a good focus. I think this is a easier task then developer environments or packaging. | 16:34:42 | |
| I won't be in the docs team meeting tomorrow (cc fricklerhandwerk) | 21:00:39 | |
| 11 Apr 2024 | ||
In reply to @fractivore:cyberia.clubYes, specifically immutability. I said that I am still new to Nix and only have a vague idea, but I would look into it more and at our next gathering include an explanation in my presentation. | 00:15:51 | |
In reply to @technicus:matrix.orgHmm, searching around for basic explanations on this, there aren't a lot of great options. So I think it's something that could be better introduced in learning resources geared towards beginners and outsiders who might be considering NixOS. | 01:34:48 | |
| "Immutable" is a property of data. It means the data can't be modified after it's first created. Rather than write a lengthy post here, I'll put something on the wiki that I can link you to. | 01:37:46 | |
| Here: https://wiki.nixos.org/wiki/FAQ#What_does_it_mean_to_say_that_NixOS_is_%22immutable%22? | 01:56:50 | |
| * Here: https://wiki.nixos.org/wiki/FAQ#What_does_it_mean_to_say_that_NixOS_is_%22immutable%22 | 01:58:02 | |
| 18:11:47 | ||
| 19:52:14 | ||
| When i make a pr on a file i am the codeowner. Do you still get notifications to review the pr? (#940) | 21:40:01 | |
| 21:59:13 | ||
In reply to @olafklingt:matrix.orgNo, but I saw the PR and it’s in my queue. The article is quite long now. Do you think it makes sense to split it up? If so, we can also do it afterwards | 22:08:17 | |
| 22:12:49 | ||
In reply to @fricklerhandwerk:matrix.orgI don't really see a point where splitting would make sense. - the Wayland part is debatable if it is necessary ... but i think it is good because it points at qemu pitfalls. | 22:17:00 | |
| 12 Apr 2024 | ||
In reply to@infinisil:matrix.orgI did get an update. I was sifting through and deleting some emails before getting here so I can't say for sure when, but maybe it was this Monday. Let me know if I can do anything to sort that out! | 17:28:08 | |
| hey all, i recently got it into my head to write a little tool which automatically edits nix files without messing them up, and got it to a point where it can remove e.g. all mentions of i have not opened a pull request with it because that'd just ping a lot of people and i'm not sure if it would be accepted or people here would even be interested, so I thought I'd ask here beforehand | 18:54:15 | |
| * hey all, i recently got it into my head to write a little tool which automatically edits nix files without messing them up, and got it to a point where it can remove e.g. all mentions of i have not opened a pull request with it because that'd just ping a lot of people and i'm not sure if it would be accepted or people here would even be interested, so I thought I'd ask here beforehand | 18:57:21 | |
| (the manual built afterwards & is identical to the manual before the change; i haven't done documentation work on nixpkgs before and am a little unsure how to do further testing/qa on this) | 19:18:45 | |
| 19:21:51 | ||
| Nice! I think we should not just rip out the infinisil, guardian of architectural sanity, please give your blessing. | 20:12:40 | |