!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

439 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
20 May 2023
@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

Show newer messages


Back to Room ListRoom Version: 6