!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

416 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
9 Apr 2024
@djacu:matrix.orgdjacu changed their profile picture.23:22:58
10 Apr 2024
@technicus:matrix.orgMiles DysonHey 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
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @technicus:matrix.org
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?

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 configuration.nix.

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
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @technicus:matrix.org
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?
*

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 configuration.nix. After doing the installation, demoing configuration.nix and answering some questions, you'll have given as much information as people can handle. Just a suggestion, of course.

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
@fractivore:cyberia.club@fractivore:cyberia.clubBottom line: covering only a small amount of material is a good idea for this sort of context.05:23:33
@technicus:matrix.orgMiles Dyson
In reply to @fractivore:cyberia.club
Bottom line: covering only a small amount of material is a good idea for this sort of context.

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
@technicus:matrix.orgMiles DysonA 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
@technicus:matrix.orgMiles DysonThe 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
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @technicus:matrix.org
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.
It'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
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @technicus:matrix.org
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.
Like, about the definitions of those terms?
06:29:30
@olafklingt:matrix.org@olafklingt:matrix.org 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
@infinisil:matrix.orginfinisil I won't be in the docs team meeting tomorrow (cc fricklerhandwerk) 21:00:39
11 Apr 2024
@technicus:matrix.orgMiles Dyson
In reply to @fractivore:cyberia.club
Like, about the definitions of those terms?
Yes, 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
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @technicus:matrix.org
Yes, 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.
Hmm, 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
@fractivore:cyberia.club@fractivore:cyberia.club"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
@fractivore:cyberia.club@fractivore:cyberia.clubHere: https://wiki.nixos.org/wiki/FAQ#What_does_it_mean_to_say_that_NixOS_is_%22immutable%22?01:56:50
@fractivore:cyberia.club@fractivore:cyberia.club * Here: https://wiki.nixos.org/wiki/FAQ#What_does_it_mean_to_say_that_NixOS_is_%22immutable%22 01:58:02
@pxc:matrix.orgpxc joined the room.18:11:47
@andi:kack.itandi- left the room.19:52:14
@olafklingt:matrix.org@olafklingt:matrix.orgWhen i make a pr on a file i am the codeowner. Do you still get notifications to review the pr? (#940)21:40:01
@anthonyrsl:matrix.orgAnthony Rsl set a profile picture.21:59:13
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @olafklingt:matrix.org
When i make a pr on a file i am the codeowner. Do you still get notifications to review the pr? (#940)
No, 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
@anthonyrsl:matrix.orgAnthony Rsl removed their profile picture.22:12:49
@olafklingt:matrix.org@olafklingt:matrix.org
In reply to @fricklerhandwerk:matrix.org
No, 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
I 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
@wamirez:matrix.orgwamirez
In reply to@infinisil:matrix.org
wamirez: I think you might have gotten update emails in the past, could you check that you don't anymore? ^
I 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
@terru:raccoon.college@terru:raccoon.college

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 lib.mdDoc from nixpkgs. I have a changeset of it applied to master or ~an hour ago here: https://github.com/NixOS/nixpkgs/compare/5d401f9ed627a869fd231f63e4f8380022dcded5...stuebinm:nixpkgs:remove-mdDoc

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
@terru:raccoon.college@terru:raccoon.college *

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 lib.mdDoc from nixpkgs. I have a changeset of it applied to master or ~an hour ago here: https://github.com/NixOS/nixpkgs/compare/5d401f9ed627a869fd231f63e4f8380022dcded5...stuebinm:nixpkgs:remove-mdDoc

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
@terru:raccoon.college@terru:raccoon.college(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
@me:indeednotjames.com@me:indeednotjames.com joined the room.19:21:51
@fricklerhandwerk:matrix.orgfricklerhandwerk

Nice! I think we should not just rip out the mdDoc definition but rather throw with an informative error message for another release.

infinisil, guardian of architectural sanity, please give your blessing.

20:12:40

Show newer messages


Back to Room ListRoom Version: 6