!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

438 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
14 Nov 2023
@bzzm3r:matrix.org@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?

18:45:52
@bzzm3r:matrix.org@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@bzzm3r:matrix.orgIf 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 documentation18:47:02
@bzzm3r:matrix.org@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.org@grahamc:nixos.orgchanged room power levels.16:08:27
@grahamc:nixos.org@grahamc:nixos.org left the room.16:08:28
@qyliss:fairydust.spaceAlyssa Ross 17:10:42
@mjolnir:nixos.orgNixOS Moderation Botchanged room power levels.18:12:13
@mjolnir:nixos.orgNixOS Moderation Botchanged room power levels.18:12:13
@infinisil:matrix.orginfinisil bzm3r: Hey, glad to see interest in helping out the documentation! 20:42:44
@infinisil:matrix.orginfinisil bzm3r: There's a docs team meeting tomorrow at 16:00 CET (see the NixOS calendar), could you join there? 20:43:55
@infinisil:matrix.orginfinisilEven if you can't make it, we can discuss your idea there :)20:44:50
@fricklerhandwerk:matrix.orgfricklerhandwerk
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:matrix.orgfricklerhandwerk
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@eisfunke:eisfunke.com changed their profile picture.22:41:23
16 Nov 2023
@infinisil:matrix.orginfinisil asymmetric: Ping regarding the transfer of nixdoc 00:37:17
@i97henka:matrix.orgi97henkaI won't be able to join the doc meeting today. Have a good session!14:24:26
@infinisil:matrix.orginfinisil 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:matrix.orginfinisilIt was about to be merged recently, but got some comments. It would be great if we could help out getting it merged18:32:52
@ryantm:matrix.orgryantmYeah, 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@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@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:matrix.orgArtturin
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@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:matrix.orgArtturin

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:matrix.orgArtturin *

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:matrix.orgArtturinSo a adding a new argument isn't needed if you're okay with that trick22:12:28
@olafklingt:matrix.org@olafklingt:matrix.org what is the _: syntax? in nixos = _: old 22:16:36
@alex:tunstall.xyzAlex
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:matrix.orgArtturin
In reply to @olafklingt:matrix.org
what is the _: syntax? in nixos = _: old
(the _ can be anything)
22:17:30

Show newer messages


Back to Room ListRoom Version: 6