!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

420 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
6 Feb 2024
@fractivore:cyberia.club@fractivore:cyberia.clubBut yeah my motivation here isn't just entirely selflessly wanting to document stuff for the community. I mean I do want to give back to the community, but I also need to spend a lot more time reading existing docs to get a better understanding of Nix and NixOS myself. I thought an efficient way of deepening my own understanding while also contributing would be to go through all of the existing materials and make diagrams of stuff that jumped out of me. Then I can present the diagrams, where they can be accepted and/or modified or rejected. That being said I'm also very happy to take feedback on stuff that is under-documented or lends itself well to diagrams or whatever, I mean I like to be useful16:48:32
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @fractivore:cyberia.club
But yeah my motivation here isn't just entirely selflessly wanting to document stuff for the community. I mean I do want to give back to the community, but I also need to spend a lot more time reading existing docs to get a better understanding of Nix and NixOS myself. I thought an efficient way of deepening my own understanding while also contributing would be to go through all of the existing materials and make diagrams of stuff that jumped out of me. Then I can present the diagrams, where they can be accepted and/or modified or rejected. That being said I'm also very happy to take feedback on stuff that is under-documented or lends itself well to diagrams or whatever, I mean I like to be useful
Yes, writing down (or graphing) what you understand and bouncing that against people is a great way to learn!
16:50:22
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @dmills27:matrix.org
Greetings everyone, Season of Docs opened up their applications on the 2nd of February. I wanted to check with you guys if you're fine with me coordinating this activity for the NixOS Foundation? I have previously successfully managed a prior Season of Docs participant in 2022 (see 'Talawa' in https://developers.google.com/season-of-docs/docs/2022/participants). If everyone agrees, I can draft a CFP in the following days that details the strategies we could use for this edition of the programme.

Hey, it would be great if you kicked of the process with a CFP, because we should definitely take the opportunity to get funding.

How far do you want to go with it? Are you willing and available to drive it to conclusion: progress tracking, evaluation, final report, the whole project management long tail?

16:56:34
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @dmills27:matrix.org
Greetings everyone, Season of Docs opened up their applications on the 2nd of February. I wanted to check with you guys if you're fine with me coordinating this activity for the NixOS Foundation? I have previously successfully managed a prior Season of Docs participant in 2022 (see 'Talawa' in https://developers.google.com/season-of-docs/docs/2022/participants). If everyone agrees, I can draft a CFP in the following days that details the strategies we could use for this edition of the programme.
* Hey, it would be great if you kicked off the process with a CFP, because we should definitely take the opportunity to get funding.
How far do you want to go with it? Are you willing and available to drive it to conclusion: progress tracking, evaluation, final report, the whole project management long tail?
17:07:55
@fricklerhandwerk:matrix.orgfricklerhandwerk * Dominic Mills: Hey, it would be great if you kicked off the process with a CFP, because we should definitely take the opportunity to get funding.

How far do you want to go with it? Are you willing and available to drive it to conclusion: progress tracking, evaluation, final report, the whole project management long tail? (bearbeitet)
17:09:59
@megs78:matrix.orgmegs78 joined the room.19:13:44
7 Feb 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk

As part of preparing the report on the documentation team's activities of the past year (and more...)

  • Did a clean-up pass over the nix.dev issue tracker, closing duplicate and stale issues
  • Merged the results of proofconstruction's prototyping for the tutorial outline with the work done by the Learning Journey working group
  • Pinned tracking issues for the three documentation categories we cover: https://github.com/NixOS/nix.dev/issues
  • Did a bunch of small PRs to fix typos, broken links, awkward phrasing; adding missing bits, etc. (thanks infinisil oliviacrain danielsidhion for quick reviews!)
04:26:51
@dmills27:matrix.orgDominic Mills
In reply to @fricklerhandwerk:matrix.org
Dominic Mills: Hey, it would be great if you kicked off the process with a CFP, because we should definitely take the opportunity to get funding.

How far do you want to go with it? Are you willing and available to drive it to conclusion: progress tracking, evaluation, final report, the whole project management long tail? (bearbeitet)
yes, I'm willing at do all of what you just mentioned for the duration of the programme.
21:10:47
@dmills27:matrix.orgDominic Mills
In reply to @fricklerhandwerk:matrix.org
Dominic Mills: Hey, it would be great if you kicked off the process with a CFP, because we should definitely take the opportunity to get funding.

How far do you want to go with it? Are you willing and available to drive it to conclusion: progress tracking, evaluation, final report, the whole project management long tail? (bearbeitet)
* yes, I'm willing and available at do all of what you just mentioned for the duration of the programme.
21:20:51

Show newer messages


Back to Room ListRoom Version: 6