!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

436 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
22 Jul 2023
@toonn:matrix.orgtoonn Which is now just a flat list with comments indicating support tiers. 13:37:22
@asymmetric:matrix.dapp.org.ukasymmetricbtw i'veopened a separate issue for this, lmk if it's a duplicate of something else https://github.com/NixOS/nixpkgs/issues/24468618:53:52
@toonn:matrix.orgtoonn asymmetric: Oh, just pinged you on the PR I updated. 20:44:16
24 Jul 2023
@i97henka:matrix.orghenrik-chI won't be able to join today's meeting. Have a good session!13:32:55
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @toonn:matrix.org
asymmetric: Oh, just pinged you on the PR I updated.
i'm primarily interested in documenting the tiers in the manual, as that's where most users would go and check, imo. the manual could/should reference the location in nixpkgs where this is codified, if one exists. Not sure where that would be, after reading amjoseph's review
13:54:19
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @toonn:matrix.org
asymmetric: Oh, just pinged you on the PR I updated.
* i'm primarily interested in documenting the tiers in the manual, as that's where most users would go and check, imo. the manual could/should reference the location in nixpkgs where this is codified, if one exists. Not sure where that would be though, after reading amjoseph's review
13:54:36
@proofconstruction:matrix.orgproofconstructionWon't be at the meetings today or Thursday, taking a break from computers to go fishing (stream processing)19:17:53
@proofconstruction:matrix.orgproofconstructionWell I guess that sent late. Anyway19:18:11
@infinisil:matrix.orginfinisilhttps://github.com/NixOS/nixpkgs/pull/24524321:34:00
25 Jul 2023
@federicodschonborn:matrix.org@federicodschonborn:matrix.org changed their profile picture.01:57:05
@asymmetric:matrix.dapp.org.ukasymmetricI'm not sure I understand what's happening with the "postponed" column on the board. 99% of the issues there are done. How does that happen?09:39:54
@asymmetric:matrix.dapp.org.ukasymmetricalso, what's the purpose of the "prioritized" column? Prioritized for whom? AFAIU, work is taken on on a "willing to do this" basis, i.e. if somebody is assigned to a task, then it's prioritized "for them". 09:41:54
@asymmetric:matrix.dapp.org.ukasymmetric * also, what's the purpose of the "prioritized" column? Prioritized for whom? AFAIU, work is taken on on a "willing to do this" basis, i.e. if somebody is assigned to a task, then it's prioritized "for them". Is it supposed to capture "prioritized for the whole team"? If so, I don't see that as reflecting how the team has worked so far, and in any case, it takes up space without being used much. So I propose to remove it09:42:41
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @asymmetric:matrix.dapp.org.uk
I'm not sure I understand what's happening with the "postponed" column on the board. 99% of the issues there are done. How does that happen?
Also what's the difference between postponed and stale?
09:43:19
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @asymmetric:matrix.dapp.org.uk
I'm not sure I understand what's happening with the "postponed" column on the board. 99% of the issues there are done. How does that happen?
* Also what's the difference between postponed and stale? I propose we remove stale
09:43:49
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @asymmetric:matrix.dapp.org.uk
I'm not sure I understand what's happening with the "postponed" column on the board. 99% of the issues there are done. How does that happen?
Also, does anyone know why the automation which should move merged PRs and closed issues to "done" isn't working? Is it just that it's not retroactive?
09:47:38
@asymmetric:matrix.dapp.org.ukasymmetric infinisil: just created this: https://github.com/NixOS/nixpkgs/pull/245358. Not sure how it interacts with https://github.com/NixOS/nixpkgs/issues/244056, I guess whichever gets merged first needs to take the other one into consideration 10:22:32
@asymmetric:matrix.dapp.org.ukasymmetric cc pennae 10:22:41
@infinisil:matrix.orginfinisil
In reply to @asymmetric:matrix.dapp.org.uk
infinisil: just created this: https://github.com/NixOS/nixpkgs/pull/245358. Not sure how it interacts with https://github.com/NixOS/nixpkgs/issues/244056, I guess whichever gets merged first needs to take the other one into consideration
Yeah, my PR will take a while still, I'll rebase it as needed :)
10:25:12
@asymmetric:matrix.dapp.org.ukasymmetricposting this draft here for early feedback, as the topic is not my area of expertise: https://github.com/NixOS/nixpkgs/pull/24536811:42:44
@asymmetric:matrix.dapp.org.ukasymmetricRedacted or Malformed Event11:43:22
@nikstur:matrix.orgniksturWe have some NixOS documentation outside the nixos/doc/manual tree, e.g.: https://github.com/NixOS/nixpkgs/tree/master/nixos/modules/system/boot/loader/external Is this something we want to support/encourage in the long run? I think it's nice because it keeps the docs close to the code but on the other hand its makes it more difficult for docs contributors to find the source.13:44:55
@nikstur:matrix.orgnikstur * We have some NixOS documentation outside the nixos/doc/manual tree, e.g.: https://github.com/NixOS/nixpkgs/tree/master/nixos/modules/system/boot/loader/external Is this something we want to support/encourage in the long run? I think it's nice because it keeps the docs close to the code but on the other hand it makes it more difficult for docs contributors to find the source.13:45:05
@infinisil:matrix.orginfinisil nikstur: +1 from me, having documentation right next to the implementation makes it easy to update it 13:52:04
@raboof:matrix.orgraboofRedacted or Malformed Event13:59:42
@nikstur:matrix.orgnikstur
In reply to @raboof:matrix.org
yeah, if you can change 'the thing' and 'the documentation for the thing' in the same commit, that's very helpful both when reviewing it and when looking at the change in the history
But this would also be possible if the docs lay somewhere completely different in the repo
14:02:31
@raboof:matrix.orgraboof🤦sorry I misread, nvm14:03:44
@ncfavier:matrix.orgncfavier changed their profile picture.16:43:13
26 Jul 2023
@infinisil:matrix.orginfinisil asymmetric: Ping for https://github.com/nix-community/nixdoc/pull/62 :) 16:50:41
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
asymmetric: Ping for https://github.com/nix-community/nixdoc/pull/62 :)
Traveling today, will look at it tomorrow hopefully
19:53:14

Show newer messages


Back to Room ListRoom Version: 6