!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

422 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

Load older messages


SenderMessageTime
21 Nov 2023
@artturin:matrix.orgArtturinhttps://github.com/NixOS/nixpkgs/pull/26547822:20:54
22 Nov 2023
@zarel_it:matrix.org@zarel_it:matrix.org left the room.09:40:37
@olafklingt:matrix.org@olafklingt:matrix.orgI am trying to improve the reproducible nixos-generate-config. it would be nice if we could not reproduce the installer configuration but by use the installer configuration as defined in https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/installer/cd-dvd/installation-cd-graphical-base.nix ... but i have no idea how to do that. (i already commented on this on the ticket but i think here is a better place if someone has an idea)15:46:22
@olafklingt:matrix.org@olafklingt:matrix.org * I am trying to improve the reproducible nixos-generate-config. it would be nice if we could not reproduce the installer configuration but use the installer configuration as defined in https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/installer/cd-dvd/installation-cd-graphical-base.nix ... but i have no idea how to do that. (i already commented on this on the ticket but i think here is a better place if someone has an idea)15:57:44
@olafklingt:matrix.org@olafklingt:matrix.org what i don't want to do is this because one would need to have a copy of nixpkgs around:
nix-shell -p "with (import ./. {}); (nixos { imports = [./nixos/modules/installer/cd-dvd/installation-cd-graphical-gnome.nix ]; }).config.system.build.nixos-generate-config"
16:30:24
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @olafklingt:matrix.org
I am trying to improve the reproducible nixos-generate-config. it would be nice if we could not reproduce the installer configuration but use the installer configuration as defined in
https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/installer/cd-dvd/installation-cd-graphical-base.nix ... but i have no idea how to do that. (i already commented on this on the ticket but i think here is a better place if someone has an idea)
which ticket, sorry?
16:57:16
@olafklingt:matrix.org@olafklingt:matrix.orghttps://github.com/NixOS/nix.dev/pull/804#issuecomment-182300317416:59:57
23 Nov 2023
@artturin:matrix.orgArtturin
In reply to @olafklingt:matrix.org
what i don't want to do is this because one would need to have a copy of nixpkgs around:
nix-shell -p "with (import ./. {}); (nixos { imports = [./nixos/modules/installer/cd-dvd/installation-cd-graphical-gnome.nix ]; }).config.system.build.nixos-generate-config"
import <nixpkgs> would use the channel
19:13:14
@artturin:matrix.orgArtturin
In reply to @olafklingt:matrix.org
what i don't want to do is this because one would need to have a copy of nixpkgs around:
nix-shell -p "with (import ./. {}); (nixos { imports = [./nixos/modules/installer/cd-dvd/installation-cd-graphical-gnome.nix ]; }).config.system.build.nixos-generate-config"
and (pkgs.path + "/nixos/modules/installer/cd-dvd/installation-cd-graphical.gnome.nix") can be used in imports
19:15:47
@olafklingt:matrix.org@olafklingt:matrix.org Artturin: thank you. thats much more straightforward than i thought. 23:08:43
@infinisil:matrix.orginfinisilHaving tutorials in a separate repo is actually kind of terrible because you can't introduce a feature and also mention it in a tutorial at the same time, you instead need two PRs23:22:26
@infinisil:matrix.orginfinisilAnd with the current rendering pipeline it's especially terrible because you can't link to the reference manuals until the channels advanced23:22:58
24 Nov 2023
@adam:robins.wtf@adam:robins.wtf Are there thoughts about combining them? 00:25:14
@infinisil:matrix.orginfinisil adamcstephens 🐝: I think most people are onboard with that idea, but nobody has the resources and knowledge to execute it! 00:29:40
@infinisil:matrix.orginfinisilWell, the basic idea being that you render from multiple sources00:30:12
25 Nov 2023
@tejing:matrix.org@tejing:matrix.org joined the room.04:47:47
@tejing:matrix.org@tejing:matrix.orgI'm working on a nixos module to improve the UX of trying to run ELF binaries not made for nixos: https://github.com/NixOS/nixpkgs/pull/269551 I've quickly realized I need a documentation entry point to link to, since explaining everything people want to know makes the message too long. Afaik there isn't really a proper place for that currently. Any thoughts on where this really should live?04:52:16
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @tejing:matrix.org
I'm working on a nixos module to improve the UX of trying to run ELF binaries not made for nixos: https://github.com/NixOS/nixpkgs/pull/269551

I've quickly realized I need a documentation entry point to link to, since explaining everything people want to know makes the message too long. Afaik there isn't really a proper place for that currently.

Any thoughts on where this really should live?
there is a section of nix.dev that is called "guides"
05:55:55
@bzzm3r:matrix.org@bzzm3r:matrix.orgwhich has a section called "recipes"05:56:39
@bzzm3r:matrix.org@bzzm3r:matrix.orgwould this fit there? 05:56:46
@tejing:matrix.org@tejing:matrix.orgThat's certainly a better place than I'd thought of yet. Another possibility is to add something directly on https://nixos.org/learn, maybe? Perhaps both. We want accessibility, since this is the most likely reason for a nixos user to start learning the nix language and getting deeper into the nix ecosystem, but nix.dev does seem like a better place for the guide to actually live.06:14:56
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @tejing:matrix.org
That's certainly a better place than I'd thought of yet. Another possibility is to add something directly on https://nixos.org/learn, maybe? Perhaps both. We want accessibility, since this is the most likely reason for a nixos user to start learning the nix language and getting deeper into the nix ecosystem, but nix.dev does seem like a better place for the guide to actually live.
hmm, yeah, i have seen various sections in the manuals linked under nixos.org which give fairly specific guide/recipe style advice (as in, using some of the more general concepts discussed in order to address the specific use cases where they often come up...for example i remember running into some BLAS/LAPACK setup mini-guides...)
06:54:52
@bzzm3r:matrix.org@bzzm3r:matrix.orgbut these tend to be very short too? 06:55:00
@bzzm3r:matrix.org@bzzm3r:matrix.orgnot entirely sure, but keep in mind that i'm not on the docs team, and just a bystander. i'm sure someone more qualified will be around soon in order to help answer this definitively06:55:44
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @proofconstruction:matrix.org

I was just confused about "why the thing people seem to be using the most" is not the thing we are also documenting.

Indeed this is a giant problem: the thing people are using the most is also the most broken. This is not really even my opinion, but a matter of technical fact. I even use flakes for my own system configurations, but this is still the case largely because I, like so many, adopted that workflow without any awareness of the problems lurking beneath the surface (also at the surface; flake.nix is not even a valid Nix file!)

I made an attempt to switch from a flakes based NixOS configuration, to a npins managed standard configuration.nix based one. I almost got there, but couldn't figure out the last trick (getting nixos-rebuild to use the pinned packages instead of whatever it has in store). I found various bits of information about it on the internet (in the context of niv, which I think is mostly applicable here, but ultimately couldn't figure out the last little bit (getting nixos-rebuild switch to work), and I am conceptually lost enough now that the most I can do is write out a Discourse post discussing the situation, and hoping for the best.

So, for now, I am tucking my tail between my legs and trotting off back to flakes.nix. The solution might lie in simply doing a live reboot from an iso that is built that is built using an npins managed nixpkgs from the start (rather than rebuild switching into it).

But yeah, I can see why you'd just continue carrying on with flakes.nix, if yours is already quite complicated (mine isn't, it's just a glorified pinned entrypoint into my configuration modules).

20:53:24
@bzzm3r:matrix.org@bzzm3r:matrix.orgI've also had one small victory in the last two weeks, which is that I spent quite a bit of time, writing quite a bit of Nix. (I got caught up in a very silly project, that just happened to have this side-benefit: configuring my starship prompt using only Nix.) In general, Nix-lang is far more readable for me (I'm not sure why I found overlays confusing anymore; it's just attribute overrides 🤷, kind of like a functor).20:55:08
@bzzm3r:matrix.org@bzzm3r:matrix.orgWhile I'm not sure I can make it to weekly meetings (anxiety), I think I'm slowly clobbering together enough to eventually contribute more documentation. 20:56:40
26 Nov 2023
@infinisil:matrix.orginfinisil
In reply to @bzzm3r:matrix.org

I made an attempt to switch from a flakes based NixOS configuration, to a npins managed standard configuration.nix based one. I almost got there, but couldn't figure out the last trick (getting nixos-rebuild to use the pinned packages instead of whatever it has in store). I found various bits of information about it on the internet (in the context of niv, which I think is mostly applicable here, but ultimately couldn't figure out the last little bit (getting nixos-rebuild switch to work), and I am conceptually lost enough now that the most I can do is write out a Discourse post discussing the situation, and hoping for the best.

So, for now, I am tucking my tail between my legs and trotting off back to flakes.nix. The solution might lie in simply doing a live reboot from an iso that is built that is built using an npins managed nixpkgs from the start (rather than rebuild switching into it).

But yeah, I can see why you'd just continue carrying on with flakes.nix, if yours is already quite complicated (mine isn't, it's just a glorified pinned entrypoint into my configuration modules).

Yeah nixos-rebuild really can't do that, which is why I wrote a small wrapper in https://github.com/infinisil/sanix
07:03:14
@infinisil:matrix.orginfinisilI wrote this exactly for what you were trying :)07:04:42
@olafklingt:matrix.org@olafklingt:matrix.org where do i find the functions pkgs.nixos and pkgs.path in the nixpkgs manual? only found nixos but pkgs.path nowhere. 13:54:26

Show newer messages


Back to Room ListRoom Version: 6