Nix Documentation | 438 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 91 Servers |
| Sender | Message | Time |
|---|---|---|
| 14 Nov 2023 | ||
| Anyway, I'm interested in contributing a series of small packages to Likely these can also be referenced in the docs, but for now, my goal is in particular, to get the examples out. Do you all think this makes sense as a project? If it does then: as I am a complete Nix beginner (I have just gotten my NixOS setup stable after 2+ weeks of work), I would really benefit from being able to ask for help (the alternative is to get side-tracked with random information from the internet, until I am ultimately corrected by someone who knows better). Where would it be appropriate for me to ask questions without worry/judgement? | 18:45:52 | |
| (One possible solution for the last point is to have a dedicated Discourse thread for each particular example I am building?) | 18:46:18 | |
| If my labour/effort would be better spent elsewhere, I am happy to do that instead too. In general I would like to help with documentation/wiki-style documentation | 18:47:02 | |
| (Also, for now, I only plan to tackle the following "major" languages, and this might already be too big a list: Rust, Haskell, TypeScript/JavaScript, Python, Go, C, C++) | 18:49:30 | |
| 15 Nov 2023 | ||
| 16:08:27 | ||
| 16:08:28 | ||
| 17:10:42 | ||
| 18:12:13 | ||
| 18:12:13 | ||
| bzm3r: Hey, glad to see interest in helping out the documentation! | 20:42:44 | |
| bzm3r: There's a docs team meeting tomorrow at 16:00 CET (see the NixOS calendar), could you join there? | 20:43:55 | |
| Even if you can't make it, we can discuss your idea there :) | 20:44:50 | |
In reply to @bzzm3r:matrix.org If you can devote time to that, it would be a blast. There's a fairly old issue about it here, but it's still on the radar: https://github.com/NixOS/nix.dev/issues/278 You'll surely get lots of feedback on the didactic part and about generic Nix aspects from the docs team, and it may be worth upstreaming things into Nixpkgs on the side to get maintainer feedback for stylistic. And while I really don't want to hamper your enthusiasm, expect it to be a big project that may not terminate within your available time. The reference documentation is often so sparse it's useless. Start out with one language, do a cheap draft and bounce it against us. | 20:48:58 | |
In reply to @bzzm3r:matrix.org* If you can devote time to that, it would be a blast. There's a fairly old issue about it here, but it's still on the radar: https://github.com/NixOS/nix.dev/issues/278 You'll surely get lots of feedback on the didactic part and about generic Nix aspects from the docs team, and it may be worth upstreaming things into Nixpkgs on the side to get maintainer feedback on style and conventions. And while I really don't want to hamper your enthusiasm, expect it to be a big project that may not terminate within your available time. The reference documentation is often so sparse it's useless. Start out with one language, do a cheap draft and bounce it against us. | 20:49:21 | |
| 22:41:23 | ||
| 16 Nov 2023 | ||
| asymmetric: Ping regarding the transfer of nixdoc | 00:37:17 | |
| I won't be able to join the doc meeting today. Have a good session! | 14:24:26 | |
| I'd like to highlight ryantm's PR to add a new split Nixpkgs manual render: https://github.com/NixOS/nixpkgs/pull/108063 🚀 | 18:32:28 | |
| It was about to be merged recently, but got some comments. It would be great if we could help out getting it merged | 18:32:52 | |
| Yeah, haven't had a chance to address those comments. The inotify stuff is something I'm not particularly familiar with. | 18:56:41 | |
| i am trying to react to fricklerhandwerk comment in a pr. but i am stuck. I am wondering how one could pass a configuration option to
so that xserverEnabled is true independent from the host configuration. so that it is passed to the script here | 21:51:01 | |
| * i am trying to react to fricklerhandwerk comment in a pr. but i am stuck. I am wondering how one could pass a configuration option to
so that xserverEnabled is true independent from the host configuration. so that it is passed to the script here or rather here to be more precise. | 21:59:16 | |
In reply to @olafklingt:matrix.org
however that only contains
Instead of re-implement what the package is doing it would be better to add a argument to the package which will then be passed to the | 22:06:20 | |
In reply to @artturin:matrix.orgthank you Artturin | 22:08:58 | |
| It's possible to override the
| 22:10:00 | |
| * It's possible to override the
| 22:10:42 | |
| So a adding a new argument isn't needed if you're okay with that trick | 22:12:28 | |
what is the _: syntax? in nixos = _: old | 22:16:36 | |
In reply to @olafklingt:matrix.org _: old is a function that ignores its argument and returns old | 22:17:10 | |
In reply to @olafklingt:matrix.org(the _ can be anything) | 22:17:30 | |