!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

420 Members
Discussion about documentation improvements around the Nix ecosystem84 Servers

Load older messages


SenderMessageTime
20 May 2023
@kranzes:matrix.org@kranzes:matrix.org
In reply to @charles:computer.surgery
Does Nix/NixOS have an equivalent documentation page to https://wiki.archlinux.org/title/Help:Reading#Installation_of_packages?
We have it in the manual I believe
13:38:03
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:38:19
@kranzes:matrix.org@kranzes:matrix.orgthere's also this13:38:23
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:38:55
@kranzes:matrix.org@kranzes:matrix.orgimage.png
Download image.png
13:39:05
@charles:computer.surgeryCharles👀15:54:08
@wiseh:matrix.org@wiseh:matrix.org

Does Nix/NixOS have an equivalent documentation page to https://wiki.archlinux.org/title/Help:Reading#Installation_of_packages?

You may also be interested in this https://github.com/NixOS/nix.dev/issues/554

22:08:18
@charles:computer.surgeryCharlesooh, yes22:09:45
@charles:computer.surgeryCharlesthe main use-case i had in mind for such a piece of documentation is similar to how the Arch page is used throughout its wiki: instead of giving a concrete example of how to install a package, things just link to a generic page explaining all the ways it can be done (and ideally enumerating the differences between each method)22:19:41
@charles:computer.surgeryCharlesthe linked issue sounds like it's heading towards that sort of thing, which is great22:20:16
@charles:computer.surgeryCharles * the main use-case i had in mind for such a piece of documentation is similar to how the Arch page is used throughout its wiki: instead of giving a concrete example of how to install a package in every single piece of software's own documentation, things just link to a generic page explaining all the ways it can be done (and ideally enumerating the differences between each method)22:20:57
@charles:computer.surgeryCharlespersonally i was kind of imagining a reference-style thing where there's a Q&A matrix and then based on your answers you can get directed to a section explaining how to install a package given your answers to the question22:24:22
@charles:computer.surgeryCharlesquestions including things like "are you on nixos", "is it in nixpkgs", "are you using flakes", "do you want it installed globally or for your user only", "do you want it installed permanently or just to use it temporarily", etc22:25:12
@charles:computer.surgeryCharles * personally i was kind of imagining a reference-style thing where there's a Q&A matrix and then based on your answers you can get directed to a section explaining how to install a package given your answers to the questions22:26:10
@charles:computer.surgeryCharles * questions including things like "are you on nixos", "is it in nixpkgs", "are you using flakes", "do you want it installed globally (configuration.nix), for your user only (home-manager), or in a specific project environment only (shell.nix)", "do you want it installed permanently (declarative) or just to use it temporarily (nix-shell)", etc22:27:46
@charles:computer.surgeryCharles(i don't have particularly strong feelings as to exactly how this information is presented, i'm just throwing some ideas around)22:30:13
21 May 2023
@asymmetric:matrix.dapp.org.ukasymmetric does anyone understand sphinx? i'd like to add a link to the footer on nix.dev, but i can't find a way to do that. apparently i have to override the footer block in the default layout, but when i do, my HTML doesn't end up in the footer element 16:42:09
22 May 2023
@zmitchell:matrix.org@zmitchell:matrix.org

I’ll take a look, sometimes that kind of config is in conf.py at the top level of the repo

12:33:25
23 May 2023
@j-k:matrix.orgj-kWe have release notes for nixos but we don't really have anything for nixpkgs itself, has this been raised before? buildFHSEnv moving from the chroot version to bubblewrap has broken a couple things and will be pretty much invisible to people updating to 23.05. There's a comment in all-packages.nix but that's not particularly visible https://github.com/NixOS/nixpkgs/pull/22574813:30:31
@raitobezarius:matrix.orgraitobezarius

We have release notes for nixos but we don't really have anything for nixpkgs itself, has this been raised before?

it's really the nixos releases usually

13:31:13
@raitobezarius:matrix.orgraitobezariusthis has been raised before by multiple contributors13:31:21
@wiseh:matrix.org@wiseh:matrix.org Minijackson I found this, in case it might help you! https://vi.stackexchange.com/questions/2846/how-to-set-up-vim-to-work-with-one-sentence-per-line 17:15:01
@Minijackson:matrix.orgMinijacksonooooh, thanks a lot! I'll certainly try this ^^17:15:39
25 May 2023
@asymmetric:matrix.dapp.org.ukasymmetricI won’t be able to attend today, sorry!13:00:30
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to disko in NixOS 23.11 when.13:32:21
@raitobezarius:matrix.orgraitobezarius changed their display name from disko in NixOS 23.11 when to raitobezarius.13:37:27
26 May 2023
@pennae:matrix.eno.space@pennae:matrix.eno.space zmitchellfricklerhandwerk: do we have any feedback about keeping/dropping the epub export (temporarily) yet? 15:07:25
@infinisil:matrix.orginfinisil
In reply to @pennae:matrix.eno.space
zmitchellfricklerhandwerk: do we have any feedback about keeping/dropping the epub export (temporarily) yet?
How about we change the epub to be just a single page telling users that it's deprecated and linking to the html manual instead. Also to report it in an issue if somebody depends on epub.
15:42:26
@pennae:matrix.eno.space@pennae:matrix.eno.spacewe can do that. all we need is a decision which way to go15:43:06
@infinisil:matrix.orginfinisilIf we don't have any feedback to epub, I think that idea is what we should do. In particular now that the release is branched off, so users have lots of time to report that they need epub until the next release15:44:20

Show newer messages


Back to Room ListRoom Version: 6