| 10 Oct 2024 |
@johannes.kirschbauer:scs.ems.host | Maybe we can raise a pot of Money for all the Framework and infra refactoring Tasks. | 10:59:59 |
| p4cmanus3r joined the room. | 13:26:17 |
fricklerhandwerk | In reply to @johannes.kirschbauer:scs.ems.host Maybe we can raise a pot of Money for all the Framework and infra refactoring Tasks. Yes, we can put up a funding goal on https://opencollective.com/nixos/projects/nix-documentation
Just need to define concrete, achievable deliverables.
| 14:27:17 |
| requiem33 joined the room. | 22:40:04 |
| 15 Oct 2024 |
| detroyejr joined the room. | 02:55:49 |
| dish [Fox/It/She] joined the room. | 03:21:33 |
| @marshmallow:althaea.zone joined the room. | 06:17:43 |
| lassulus joined the room. | 07:45:33 |
| unaboomer_ joined the room. | 08:11:17 |
| 17 Oct 2024 |
| tdillenburg changed their display name from tiagod to tdillenburg. | 01:41:41 |
| Dominic Mills set a profile picture. | 17:15:08 |
ronef | Hey, every NixCon I do a collaborative "State of the Union" where folks from various efforts/teams come share a slide for two minutes and a call to action. Thought to check if someone from the docs team might be interested and is coming to NixCon! | 20:55:27 |
| 19 Oct 2024 |
| jwillikers joined the room. | 12:09:32 |
| mwoodpatrickmx joined the room. | 17:01:01 |
| 22 Oct 2024 |
| willbush changed their profile picture. | 09:29:11 |
| @federicodschonborn:matrix.org joined the room. | 12:16:59 |
| Oleg Kaminskiy joined the room. | 23:46:10 |
| 23 Oct 2024 |
Christian Brunbjerg | It seems that I need to study the documentation more before, I can contribute.
I will donate to the Nix Documentation team as a first step.
Also, I have been reading through the dev.nix and of the parts that I have read I think does a really good job!
I may have visited nix.dev before, if I had it was not clear to me that nix.dev serves as an entrypoint for all the other documentation sources.
Also, the fact that when you go to nixos.org and from the main page are not 100% certain where the main documentation site is, seems to me a pressing point (what do you guys think?). Ideally we should be directing as much trafic through nix.dev as possible when people are looking for documentation?ronef | 20:28:09 |
Christian Brunbjerg | * It seems that I need to study the documentation more before, I can contribute.
I will donate to the Nix Documentation team as a first step.
Also, I have been reading through the dev.nix and of the parts that I have read I think does a really good job!
I may have visited nix.dev before, if I had it was not clear to me that nix.dev serves as an entrypoint for all the other documentation sources.
Also, the fact that when you go to nixos.org and from the main page are not 100% certain where the main documentation site is, seems to me a pressing point (what do you guys think?). Ideally we should be directing as much trafic through nix.dev as possible when people are looking for documentation? | 20:28:20 |
| 24 Oct 2024 |
fricklerhandwerk | In reply to @ronef:matrix.org Hey, every NixCon I do a collaborative "State of the Union" where folks from various efforts/teams come share a slide for two minutes and a call to action. Thought to check if someone from the docs team might be interested and is coming to NixCon! Johannes Kirschbauer @hsjobeki: do you want to add something about doc comments last minute? | 08:39:56 |
@johannes.kirschbauer:scs.ems.host | Uh i didnt plan. But it would be so nice to call for help with the Last Bits of migration | 08:41:00 |
@johannes.kirschbauer:scs.ems.host | @ronef:matrix.org: i am going on train now. A little Community effort to finish with doc-comments migration would be so nice. Its been a huge milestone and is actually very easy. But a lot of handwork is required.
I could make a little guide for how to do it with the hope that some people are willing to jump in for the missing mile | 08:44:07 |
fricklerhandwerk | In reply to @brunbjerg:matrix.org It seems that I need to study the documentation more before, I can contribute.
I will donate to the Nix Documentation team as a first step.
Also, I have been reading through the dev.nix and of the parts that I have read I think does a really good job!
I may have visited nix.dev before, if I had it was not clear to me that nix.dev serves as an entrypoint for all the other documentation sources.
Also, the fact that when you go to nixos.org and from the main page are not 100% certain where the main documentation site is, seems to me a pressing point (what do you guys think?). Ideally we should be directing as much trafic through nix.dev as possible when people are looking for documentation? Thanks a lot for the financial support!!
And adding clearer pointers to documentation from nixos.org would certainly help | 08:55:45 |
ronef | Johannes Kirschbauer @hsjobeki: see if there's anything you'd want to add here about it Are you going to be around at NixCon? https://docs.google.com/presentation/d/1G9Rc6cxWKgMM1q0DtgwyWUauBZ0vBLhAiV3M5ZuvEyo/edit#slide=id.g23efee59dda_0_212 | 09:05:12 |
@johannes.kirschbauer:scs.ems.host | In reply to @ronef:matrix.org Johannes Kirschbauer @hsjobeki: see if there's anything you'd want to add here about it Are you going to be around at NixCon? https://docs.google.com/presentation/d/1G9Rc6cxWKgMM1q0DtgwyWUauBZ0vBLhAiV3M5ZuvEyo/edit#slide=id.g23efee59dda_0_212 Yes i will be there starting from today 6pm | 09:21:40 |
@johannes.kirschbauer:scs.ems.host | @fricklerhandwerk:matrix.org: do we want to add nix-documentation team Slide?
There was quite some stuff Happening this year.
Stuff for reference documentation
- Jan noogle 2024 released
- doc-comments now implemented in nix-repl (roberth ported from lix i think)
- Infra / Domain Changed (you did this i think with roberth)
- multi Version nix Manual
- nix.dev (i dont know what Majors happened there)
... Maybe we should sit down and Filter Out the important stuff? | 09:26:55 |
ronef | Happy for you to have a slide and take ~2 minutes for doc team updates and call to actions | 09:28:18 |
fricklerhandwerk | In reply to @johannes.kirschbauer:scs.ems.host @fricklerhandwerk:matrix.org: do we want to add nix-documentation team Slide?
There was quite some stuff Happening this year.
Stuff for reference documentation
- Jan noogle 2024 released
- doc-comments now implemented in nix-repl (roberth ported from lix i think)
- Infra / Domain Changed (you did this i think with roberth)
- multi Version nix Manual
- nix.dev (i dont know what Majors happened there)
... Maybe we should sit down and Filter Out the important stuff? Tbh IMO this year was rather quiet. We did a bunch of things for sure, but nothing qualitatively different from last year except doc comments landing. Maybe versioned Nix manuals, but that’s a lot less important for the NixCon audience than doc comments I think | 09:30:38 |
| 25 Oct 2024 |
| @aniketd:matrix.org left the room. | 06:21:05 |
h7x4 | Just a quick question about the lib type signatures - is it an active decision we have made not to note subtypes for attrsets? Or has it just become this way?
# Current state for lists
map :: (a -> b) -> [a] -> [b]
# Current state for attrs
mapAttrs :: (String -> Any -> Any) -> AttrSet -> AttrSet
# I'd like something like this
mapAttrs :: (String -> a -> b) -> { * :: a } -> { * :: b }
# Or alternatively just
mapAttrs :: (String -> a -> b) -> { a } -> { b }
| 13:52:44 |