| 14 Nov 2023 |
@bzzm3r:matrix.org | (One possible solution for the last point is to have a dedicated Discourse thread for each particular example I am building?) | 18:46:18 |
@bzzm3r:matrix.org | 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 |
@bzzm3r:matrix.org | (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 |
| @grahamc:nixos.orgchanged room power levels. | 16:08:27 |
| @grahamc:nixos.org left the room. | 16:08:28 |
| Alyssa Ross | 17:10:42 |
| NixOS Moderation Botchanged room power levels. | 18:12:13 |
| NixOS Moderation Botchanged room power levels. | 18:12:13 |
infinisil | bzm3r: Hey, glad to see interest in helping out the documentation! | 20:42:44 |
infinisil | bzm3r: There's a docs team meeting tomorrow at 16:00 CET (see the NixOS calendar), could you join there? | 20:43:55 |
infinisil | Even if you can't make it, we can discuss your idea there :) | 20:44:50 |
fricklerhandwerk | In reply to @bzzm3r:matrix.org
Anyway, I'm interested in contributing a series of small packages to nixpkgs which are meant to serve as documented examples/best-practices for how to make packages for various languages using the Nix language (i.e. no use of nix-community tools, and extremely conservative use of overlay/override: only when there is no other option).
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?
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 |
fricklerhandwerk | In reply to @bzzm3r:matrix.org
Anyway, I'm interested in contributing a series of small packages to nixpkgs which are meant to serve as documented examples/best-practices for how to make packages for various languages using the Nix language (i.e. no use of nix-community tools, and extremely conservative use of overlay/override: only when there is no other option).
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?
* 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 |
| @eisfunke:eisfunke.com changed their profile picture. | 22:41:23 |
| 16 Nov 2023 |
infinisil | asymmetric: Ping regarding the transfer of nixdoc | 00:37:17 |
henrik-ch | I won't be able to join the doc meeting today. Have a good session! | 14:24:26 |
infinisil | 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 |
infinisil | 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 |
ryantm | Yeah, haven't had a chance to address those comments. The inotify stuff is something I'm not particularly familiar with. | 18:56:41 |
@olafklingt:matrix.org | 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
$ nix-shell -p nixos-install-tools -I nixpkgs=channel:nixos-21.05
so that xserverEnabled is true independent from the host configuration. so that it is passed to the script here
| 21:51:01 |
@olafklingt:matrix.org | * 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
$ nix-shell -p nixos-install-tools -I nixpkgs=channel:nixos-21.05
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 |
Artturin | In reply to @olafklingt:matrix.org
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
$ nix-shell -p nixos-install-tools -I nixpkgs=channel:nixos-21.05
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.
nix-shell --expr "with (import <nixpkgs> {}); (nixos { services.xserver.enable = true; }).config.system.build.nixos-install" -I nixpkgs=channel:nixos-unstable
however that only contains nixos-install
pkgs.nixos-install-tools aggregates all the install tools https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/nix/nixos-install-tools/default.nix
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 nixos call here https://github.com/NixOS/nixpkgs/blob/d6400c8a2a27e8ba20971d72c76793b7c684f9ec/pkgs/tools/nix/nixos-install-tools/default.nix#L13
| 22:06:20 |
@olafklingt:matrix.org | In reply to @artturin:matrix.org
nix-shell --expr "with (import <nixpkgs> {}); (nixos { services.xserver.enable = true; }).config.system.build.nixos-install" -I nixpkgs=channel:nixos-unstable
however that only contains nixos-install
pkgs.nixos-install-tools aggregates all the install tools https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/nix/nixos-install-tools/default.nix
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 nixos call here https://github.com/NixOS/nixpkgs/blob/d6400c8a2a27e8ba20971d72c76793b7c684f9ec/pkgs/tools/nix/nixos-install-tools/default.nix#L13
thank you Artturin | 22:08:58 |
Artturin | It's possible to override the nixos argument of the package with a function and then discarding the {} part of nixos {}
$ nix-shell --expr "with (import <nixpkgs> {}); nixos-install-tools.override (old: { nixos = _: old.nixos { services.xserver.enable = true; }; })" -I nixpkgs=channel:nixos-unstable
| 22:10:00 |
Artturin | * It's possible to override the nixos argument of the package with a function and then discarding(not using) the {} part of nixos {}
$ nix-shell --expr "with (import <nixpkgs> {}); nixos-install-tools.override (old: { nixos = _: old.nixos { services.xserver.enable = true; }; })" -I nixpkgs=channel:nixos-unstable
| 22:10:42 |
Artturin | So a adding a new argument isn't needed if you're okay with that trick | 22:12:28 |
@olafklingt:matrix.org | what is the _: syntax? in nixos = _: old | 22:16:36 |
Alex | In reply to @olafklingt:matrix.org what is the _: syntax? in nixos = _: old _: old is a function that ignores its argument and returns old | 22:17:10 |
Artturin | In reply to @olafklingt:matrix.org what is the _: syntax? in nixos = _: old (the _ can be anything) | 22:17:30 |
@olafklingt:matrix.org | to avoid the need to merge options? | 22:17:53 |