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.

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.

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.

In reply to @fractivore:cyberia.club
Like, about the definitions of those terms?

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.

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)

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

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? ^

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

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

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.

Hey all

I could use some help with understanding how NRD works and how to document library files properly.

For reference, I am working on this PR that adds network functions to the nixpkgs library.
https://github.com/NixOS/nixpkgs/pull/299409

The manual is failing to build and when I try to build it locally I see this:

RuntimeError: failed to render manual manual.md
error:
        failed to render manual manual.md

caused by:
        rendering lib.md

caused by:
        rendering functions.md

caused by:
        rendering functions/library.md

caused by:
        rendering /nix/store/b94j5fg7rf3m7w6s76by60jd7hb1avry-nixpkgs-lib-docs/network.md

caused by:
bad local reference, id #function-library-lib.network.ipv4.fromCidrString not known

which i've determine to be caused by this line in the default.nix doc comment

  - [`lib.network.ipv4.fromCidrString`](#function-library-lib.network.ipv4.fromCidrString):

This makes sense that it can't find it because if I remove the line, it does build, but there is no documentation for the functions I have created in the manual.

Any advice?

okay more info I found out.

If i change the reference from

#function-library-lib.network.ipv4.fromCidrString

to

#function-library-lib.network.ipv4

it builds and renders fine

but ipv4 is just a namespace for all my functions inside of the network library. Can we not access functions inside of an attrset or do I need to write things differently so it works?