Nix Documentation | 422 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 86 Servers |
| Sender | Message | Time |
|---|---|---|
| 25 Nov 2023 | ||
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 | |
In reply to @infinisil:matrix.org🤩 | 23:49:51 | |
| 27 Nov 2023 | ||
| idk if this is the first outside contribution to nrd, but it's a good validation of the choice of moving to python that we got one, imo! https://github.com/NixOS/nixpkgs/pull/269942 | 15:36:38 | |
| 28 Nov 2023 | ||
| 15:47:32 | ||
In reply to @infinisil:matrix.orgI saw this and wondered if there was something I could do to help the official docs team. So I'm here now as an experienced dev, but NixOS neophyte. Maybe I can help document stuff when I get stuck because the docs seem to have some decent assumed knowledge that I don't currently have. | 15:49:18 | |
| 15:53:48 | ||
| curtismchale: Awesome! I think one of the easiest things to help out with is to just read through nix.dev, to both learn about Nix, and to discover the structure of nix.dev. And if you find any problems, anything that's unclear or doesn't work, file an issue in the github repo, or even better, submit a PR to fix it :) | 16:17:49 | |
hey! I've had someone skim through the Nix language basics tutorial of nix.dev, and he mentioned something quite interesting, there's no mention of the if ... then ... else ... construct | 17:42:46 | |
| is there somewhere else where it's introduced ? | 17:43:00 | |
| * is there somewhere else where it's introduced? | 17:43:01 | |
| Minijackson: Looks like an oversight! Could you open an issue for this? | 18:23:59 | |
| sure! | 18:24:23 | |
| done: https://github.com/NixOS/nix.dev/issues/817 | 18:32:24 | |
In reply to @infinisil:matrix.orgIt’s not an oversight. As mentioned at least twice in bold letters in the introduction, this is not supposed to be a complete overview but shall rather point out things that are both important and unusual about the language. Conditionals are neither, therefore they aren’t there. The article is very long already. | 19:27:33 | |
| What I could really need help with is cleaning up the language reference in the Nix manual. It’s still mostly a long meandering wall of text that needs to be a lot more concise, needs more focused examples, and most importantly syntax patterns for all the constructs. | 19:29:43 | |
| 29 Nov 2023 | ||
| You don’t think conditionals are an important part of the language? They’re one of the first things you learn in any language… | 16:50:43 | |