Nix Documentation | 432 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 89 Servers |
| Sender | Message | Time |
|---|---|---|
| 22 Nov 2023 | ||
| 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 | |
| olaf: When you're looking for Nixpkgs docs, the question shouldn't be "Where is", but rather "Is there" xD | 18:39:04 | |
| Sounds like PR material to me! | 18:39:31 | |
| Yes it should be in nixpkgs manual. | 18:43:11 | |
| I added a commit to the vm tutorial pr with a detailed description of the reproducable command. It's not finished yet but i would like to know if it is the right direction to add such a description. https://github.com/NixOS/nix.dev/pull/807/commits/ff5c7fad92acc9deb4fcd40d39eeb9300cd41cfa | 18:49:22 | |
| https://discourse.nixos.org/t/announcing-nixlang-wiki/36049 π | 19:08:23 | |
| just one more separate documentation resource just one more I promise itβs gonna fix it | 19:33:23 | |