| 12 Jan 2024 |
infinisil | asymmetric: Sounds like the label description should be updated then :) | 11:16:22 |
asymmetric | 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 | so maybe the topic label is indeed for meta discussions | 11:18:02 |
infinisil | Oh I see | 11:18:07 |
infinisil | I feel like the content vs infra distinction sounds better | 11:19:07 |
asymmetric | 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 | 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 | asymmetric: Changing both the label names and descriptions to be more obvious | 12:05:44 |
danielsidhion | 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 | yeah, 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 me | 12:38:03 |
danielsidhion | 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:
- 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
- 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 |
Chris McDonough | no 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 | I think your contribution was fine and valuable feedback to the team, I wouldn't like to lose out on those kinds of contributions personally | 16:01:12 |
infinisil | 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:
- 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
- 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 | Indeed 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 |