Nix Documentation | 422 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 86 Servers |
| Sender | Message | Time |
|---|---|---|
| 21 Nov 2023 | ||
| https://github.com/NixOS/nixpkgs/pull/265478 | 22:20:54 | |
| 22 Nov 2023 | ||
| 09:40:37 | ||
| I 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 | |
| * 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 | |
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 | |
In reply to @olafklingt:matrix.orgwhich ticket, sorry? | 16:57:16 | |
| https://github.com/NixOS/nix.dev/pull/804#issuecomment-1823003174 | 16:59:57 | |
| 23 Nov 2023 | ||
In reply to @olafklingt:matrix.orgimport <nixpkgs> would use the channel | 19:13:14 | |
In reply to @olafklingt:matrix.organd (pkgs.path + "/nixos/modules/installer/cd-dvd/installation-cd-graphical.gnome.nix") can be used in imports | 19:15:47 | |
| Artturin: thank you. thats much more straightforward than i thought. | 23:08:43 | |
| Having 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 PRs | 23:22:26 | |
| And with the current rendering pipeline it's especially terrible because you can't link to the reference manuals until the channels advanced | 23:22:58 | |
| 24 Nov 2023 | ||
| Are there thoughts about combining them? | 00:25:14 | |
| adamcstephens 🐝: I think most people are onboard with that idea, but nobody has the resources and knowledge to execute it! | 00:29:40 | |
| Well, the basic idea being that you render from multiple sources | 00:30:12 | |
| 25 Nov 2023 | ||
| 04:47:47 | ||
| 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? | 04:52:16 | |
In reply to @tejing:matrix.orgthere is a section of nix.dev that is called "guides" | 05:55:55 | |
| which has a section called "recipes" | 05:56:39 | |
| would this fit there? | 05:56:46 | |
| 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. | 06:14:56 | |
In reply to @tejing:matrix.orghmm, 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 | |
| but these tend to be very short too? | 06:55:00 | |
| not 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 definitively | 06:55:44 | |
In reply to @proofconstruction:matrix.org I made an attempt to switch from a flakes based NixOS configuration, to a So, for now, I am tucking my tail between my legs and trotting off back to But yeah, I can see why you'd just continue carrying on with | 20:53:24 | |
| I'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 | |
| While 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 | ||
In reply to @bzzm3r:matrix.orgYeah nixos-rebuild really can't do that, which is why I wrote a small wrapper in https://github.com/infinisil/sanix | 07:03:14 | |
| I wrote this exactly for what you were trying :) | 07:04:42 | |
| 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 | |