!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

350 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com Documentation office hours are open for anyone interested in solving problems, getting contributions reviewed in real time, or becoming a maintainer. Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 80 Servers

Load older messages


SenderMessageTime
13 Nov 2024
@inayet:matrix.orginayet joined the room.22:16:45
19 Nov 2024
@federicodschonborn:matrix.orgLEGO® Worm™ changed their display name from Federico Damián Schonborn to LEGO® Worm™.01:06:27
20 Nov 2024
@inayet:matrix.orginayet removed their profile picture.00:59:35
@adam:robins.wtfadamcstephens joined the room.16:53:28
@adam:robins.wtfadamcstephensHi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText16:55:26
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @adam:robins.wtf
Hi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText
I’m not even sure why examples are collapsed to begin with. Hard to find anything that way. I’d be in favor of changing it
16:57:35
@adam:robins.wtfadamcstephensIf anything I'd rather the equivalent be collapsed and the example visible by default :)16:58:05
@fricklerhandwerk:matrix.orgfricklerhandwerkI’ll gladly merge PRs!17:14:13
@adam:robins.wtfadamcstephenswhen i find some time i'll try and figure out how to do so, unless someone can point me in the right direction :)18:00:53
@fricklerhandwerk:matrix.orgfricklerhandwerk I’d take a look at the website’s HTML and then search for css files in doc to see where it’s styled.
If examples are in I’d also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs)
18:07:45
@fricklerhandwerk:matrix.orgfricklerhandwerk * I’d take a look at the website’s HTML and then search for css files in doc to see where it’s styled.
If examples are in<details> I’d also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs) 18:08:10
@fricklerhandwerk:matrix.orgfricklerhandwerk Essentially try to trace back the output to the various sources and then twiddle the knobs. There’s a devmode command in the shell inside doc that will show live updates 18:09:18
21 Nov 2024
@nerves:bark.lgbtJason Odoom changed their profile picture.02:51:49
22 Nov 2024
@numinit:matrix.orgMorgan (@numinit) joined the room.17:51:57
25 Nov 2024
@nullcube:matrix.orgNullCube joined the room.10:06:22
@noob_tea:matrix.orgteaA few months ago people were working on paginating the manual. How is that going?10:29:48
29 Nov 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @noob_tea:matrix.org
A few months ago people were working on paginating the manual. How is that going?

People is getpsyched with some eyeballs from me. It's still going and deeply in the weeds with preliminary work. You can follow progress in the work log.

I'm not sure it will fully snap together by the end of the timeline mid December, but the most important parts of making a page split possible without disrupting workflows will fairly certainly get done.

00:35:17
@noob_tea:matrix.orgtea
In reply to @fricklerhandwerk:matrix.org

People is getpsyched with some eyeballs from me. It's still going and deeply in the weeds with preliminary work. You can follow progress in the work log.

I'm not sure it will fully snap together by the end of the timeline mid December, but the most important parts of making a page split possible without disrupting workflows will fairly certainly get done.

wow, that is very detailed
08:42:44
@noob_tea:matrix.orgteathanks!08:42:49
@misuzu:matrix.orgmisuzu joined the room.17:39:49
@misuzu:matrix.orgmisuzuHi! I've stumbled on https://github.com/NixOS/nixpkgs/actions/runs/12071127791/job/33662163276?pr=341598 and I don't really understand what must be done in this new module for the NixOS manual to build properly. Is there some kind of documentation for how to properly add these redirects for modules documentation?17:44:32
@lassulus:lassul.uslassulus changed their profile picture.18:30:24
30 Nov 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk

You have to add entries to nixos/doc/manual/redirects.json, which look like this:

  "<identifier>": [
    "index.html#<identifier>",
  ]

Rationale and design documentation: https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/ni/nixos-render-docs/README.md

Once the page-split is performed, you'll also have to consider the output path of the element referred to by <identifier>, then the shape will have to be

  "<identifier>": [
    "<path/to/output/location>.html#<identifier>",
  ]
15:14:04
2 Dec 2024
@pyrox:pyrox.devdish [Fox/It/She] changed their profile picture.19:59:19
3 Dec 2024
@getchoo:matrix.orggetchoo changed their profile picture.06:06:36
7 Dec 2024
@tek:tryp.io@tek:tryp.io left the room.20:23:19
9 Dec 2024
@karlericsson:matrix.orgkarlericsson joined the room.08:01:46
14 Dec 2024
@yut0:matrix.orgyut0 joined the room.22:42:39
@yut0:matrix.orgyut0Anyone know if there is a way to generate the Appendix A page for nixpkgs (and also home-manager, nix-darwin) using the local pinned version in my flake? I don't update my flake inputs too often, so sometimes the online Appendix A pages drift from my local nixpkgs22:44:40
@toonn:matrix.orgtoonn yut0: Are you maybe looking for `man configuration.nix`? 23:46:31

Show newer messages


Back to Room ListRoom Version: 6