!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

405 Members
Discussion about documentation improvements around the Nix ecosystem78 Servers

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


SenderMessageTime
12 Jan 2024
@infinisil:matrix.orginfinisil asymmetric: Sounds like the label description should be updated then :) 11:16:22
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
asymmetric: Sounds like the label description should be updated then :)
thing is, we also have a "8.has: documentation` label, which i think gets automatically applied
11:17:45
@asymmetric:matrix.dapp.org.ukasymmetricso maybe the topic label is indeed for meta discussions11:18:02
@infinisil:matrix.orginfinisilOh I see11:18:07
@infinisil:matrix.orginfinisilI feel like the content vs infra distinction sounds better11:19:07
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
I feel like the content vs infra distinction sounds better
so are you arguing for changing, or keeping?
11:21:22
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
I feel like the content vs infra distinction sounds better
* so are you arguing for changing, or keeping, the descriptions?
11:21:30
@infinisil:matrix.orginfinisil asymmetric: Changing both the label names and descriptions to be more obvious 12:05:44
@danielsidhion:nixos.devdanielsidhion From the little I've seen, 6.topic: documentation doesn't have automation around it, so it has to be manually applied, which leads to it not being used enough/appropriately 12:24:19
@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

Show newer messages


Back to Room ListRoom Version: 6