!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

436 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

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


SenderMessageTime
12 Jan 2024
@asymmetric:matrix.dapp.org.ukasymmetricyeah, hence my recommendation to use it. but anyway, the main goal is that we don't forget prs, so really whichever one gets applied most consistently and matches our needs is fine by me12:38:03
@danielsidhion:nixos.devdanielsidhion

Just went through a rabbithole when creating a PR, and have a few questions that I think would be better asked here rather than spending even more time trying to dig things:

  1. Does anyone know why a bunch of places in our docs use the shellSession/ShellSession info on code blocks? https://github.com/search?q=repo%3ANixOS%2Fnixpkgs%20shellsession&type=code
    From my investigation, it seems to be ignored by the highlighting library we use in the manuals
  2. A look into the highlighting library used in the manuals makes me believe that the unstable manuals haven't been updated in nixos.org for at least 2 months (library was updated from v9 to v11 ~2mo ago, but the version used in nixos.org is still v9). I can't spend more time today looking into this, but I think this isn't normal. Did something break in the manual -> nixos.org pipeline?
14:45:38
@mcdonc:matrix.orgChris McDonoughno problem's gonna be solved by me bitching in here, sorry, i should have kept it to myself. thanks for the intervention. i'll try to contribute meaningfully and regulate my aversion to various comms styles.15:45:20
@lunaphied:lunaphied.meLunaphiedI think your contribution was fine and valuable feedback to the team, I wouldn't like to lose out on those kinds of contributions personally16:01:12
@infinisil:matrix.orginfinisil
In reply to @danielsidhion:nixos.dev

Just went through a rabbithole when creating a PR, and have a few questions that I think would be better asked here rather than spending even more time trying to dig things:

  1. Does anyone know why a bunch of places in our docs use the shellSession/ShellSession info on code blocks? https://github.com/search?q=repo%3ANixOS%2Fnixpkgs%20shellsession&type=code
    From my investigation, it seems to be ignored by the highlighting library we use in the manuals
  2. A look into the highlighting library used in the manuals makes me believe that the unstable manuals haven't been updated in nixos.org for at least 2 months (library was updated from v9 to v11 ~2mo ago, but the version used in nixos.org is still v9). I can't spend more time today looking into this, but I think this isn't normal. Did something break in the manual -> nixos.org pipeline?
No idea about the first, but the second one oh no..
16:15:33
@infinisil:matrix.orginfinisilIndeed there should be commits to https://github.com/NixOS/nixos-homepage/commits/master/ every day to update the website with the latest versions, but this apparently broke..16:15:58
@infinisil:matrix.orginfinisilLol: https://github.com/NixOS/nixos-homepage/actions/runs/7496066602/job/20407403287#step:5:1216:16:18
@infinisil:matrix.orginfinisil
Run bash ./scripts/update.sh
Updating flake inputs...
error: unrecognised flag '--update-input'
Try 'nix --help' for more information.
Error: Process completed with exit code 1.
16:16:29
@infinisil:matrix.orginfinisilWait there's not even a deprecation message16:19:13
@infinisil:matrix.orginfinisil

Wait what, the current latest version is 2.19.2, which does have a deprecation message (tried it locally):

warning: '--update-input' is a deprecated alias for 'flake update' and will be removed in a future version.
16:21:25
@infinisil:matrix.orginfinisilInvestigating..16:22:34
@mcdonc:matrix.orgChris McDonough danielsidhion: it's not on the list, but i'm starting to apply your function argument defintion list stuff to a PR I already have open... https://github.com/NixOS/nixpkgs/pull/277534/files 16:27:35
@infinisil:matrix.orginfinisilOhh, something really bad might be happening, the Nixpkgs master jobset doesn't exist anymore16:28:31
@infinisil:matrix.orginfinisil Never mind, it's just not listed in https://hydra.nixos.org/project/nixpkgs anymore, it does still exist: https://hydra.nixos.org/jobset/nixpkgs/trunk 16:29:50
@danielsidhion:nixos.devdanielsidhion
In reply to @mcdonc:matrix.org
danielsidhion: it's not on the list, but i'm starting to apply your function argument defintion list stuff to a PR I already have open... https://github.com/NixOS/nixpkgs/pull/277534/files
This is amazing, thanks a lot! No need to update your PR again, but I just opened https://github.com/NixOS/nixpkgs/pull/280520 to add a few more conventions that I discussed in the latest meeting.
16:31:33
@mcdonc:matrix.orgChris McDonoughgreat... i'll try to put that file in shape16:35:10
@infinisil:matrix.orginfinisil
In reply to @infinisil:matrix.org
Investigating..
Figured it out, 2.19.1 doesn't have the deprecation warning. Looks like that was only added in 2.19.2
16:35:37

Show newer messages


Back to Room ListRoom Version: 6