Nix Documentation | 404 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 79 Servers |
| Sender | Message | Time |
|---|---|---|
| 18 Mar 2024 | ||
| still thinking it might be a bit challenging to e.g. take a huge trace of nix evaluation that annotates value type info and sources at every position. but it would be so good | 07:35:14 | |
| Its basically how noogle works. (Not via traces, but value introspection) | 07:38:19 | |
| but having info inside of functions would sure be useful | 07:42:24 | |
In reply to @rina/:matrix.org If you'd document them in the same ways as: https://github.com/nixos/nixpkgs/blob/master/lib/lists.nix#L42 We can add them to the index. | 08:43:04 | |
In reply to @rina/:matrix.org* If you'd document them in the same ways as: https://github.com/nixos/nixpkgs/blob/master/lib/lists.nix#L42 We can add them to the index. (Wiring should be trivial, i can help with that) | 08:43:57 | |
| Hey docs people and Dominic Mills, how is the application to Google Season of Docs going? It we don’t get anything exciting, we can just apply for writing 2-3 key tutorials. It’s boring but we have precedence that it can work, and we can cheaply measure success by looking at the Google Search dashboard and view statistics | 20:43:06 | |
| * Hey docs people and Dominic Mills, how is the application to Google Season of Docs going? If we don’t get anything exciting, we can just apply for writing 2-3 key tutorials. It’s boring but we have precedence that it can work, and we can cheaply measure success by looking at the Google Search dashboard and view statistics | 20:43:21 | |
| I've been working it. I got some interesting ideas from danielsidhion and Shahar "Dawn" Or (mightyiam). I'll publish it publicly tomorrow or Wednesday on my Github. | 20:45:24 | |
| 19 Mar 2024 | ||
| 00:30:57 | ||
| Given there hasn't been a meeting on a Monday for essentially 2 months now, are you folks ok if I make a PR to say we only meet once a week on the nix.dev readme? Will also need to change the meeting invite on the calendar (I don't have access to it) | 07:18:20 | |
In reply to @danielsidhion:nixos.devI’ll be back the week after next | 08:10:51 | |
In reply to @johannes.kirschbauer:scs.ems.hostthanks! I am fairly busy at the moment but I hope to get to this in the next week or so. (if this should be done sooner, no need to wait for me) | 12:26:00 | |
| 21 Mar 2024 | ||
| 16:34:26 | ||
| 16:36:57 | ||
| 18:03:48 | ||
| 20:10:20 | ||
In reply to @dmills27:matrix.orgUpdates? | 21:23:35 | |
| BTW I still won't be able to make the meeting next Monday. Next meeting I'll join will be March 28. Would be great if we clarified the GSoD situation until then, it's not that much time left | 21:53:04 | |
| 22 Mar 2024 | ||
In reply to @fricklerhandwerk:matrix.orgI had some setbacks .i.e. power cuts. I'm aiming to push something out tomorrow. | 00:08:39 | |
| hi 👋 I had an idea, what do you all think about "translating" the Archlinux install wiki to NixOS? Would be called something like "Arch Install Guide for NixOS". Essentially https://wiki.archlinux.org/title/Installation_guide but with all commands and instructions replaced by their NixOS equivalent? I think it's a good idea because I always found the Arch wiki pretty complete. | 05:07:03 | |
| * hi 👋 I had an idea, what do you all think about "translating" the Archlinux install wiki to NixOS? Would be called something like "Arch Install Guide for NixOS". Essentially https://wiki.archlinux.org/title/Installation_guide but with all commands and instructions replaced by their NixOS equivalent? I think it's a good idea because I always found the Arch wiki pretty complete. I don't have a timeline to work on this but was already wondering if ppl found this to be a good idea. | 05:07:39 | |
| 05:14:12 | ||
| 05:24:36 | ||
| 05:24:46 | ||
| our install guide is terrible last i looked. it might have got better in the mean time though | 07:06:37 | |
| i think such patches might be gleefully accepted in the docs? | 07:06:58 | |
In reply to @jade_:matrix.orgYes, if there's someone available to accept them. Help greatly appreciated. | 08:58:05 | |
In reply to @ibizaman:matrix.orgWe had a similar questions about a year ago, and I think there's no doubt that NixOS installation instructions are much behind Arch on many levels. Back then the main concern was: Sure, please port whatever, but who's gonna maintain it? That's the main difference between Nix* documentation and the Arch wiki: They have multiple highly active maintainers, and the docs team right now barely managed to extend its reach to the Nixpkgs manual. If you want to take responsibility for a chunk of NixOS documentation, please go ahead! | 09:00:07 | |
In reply to @ibizaman:matrix.orgA agree that a good installation guide is the most important missing bit in nixos documentation. So every step into that direction is great. Please don't feel scared away by maintainance, that should not be a problem. | 09:55:33 | |
| Awesome, I’m glad for the positive feedback! 😊 What takes me a long time usually when writing is figuring out all the ideas and how they should fit in what order. I’m hoping that time will be reduced drastically by copying another great example which served me well a bunch of times already. | 14:22:21 | |