!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

412 Members
Discussion about documentation improvements around the Nix ecosystem82 Servers

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


SenderMessageTime
13 Jul 2023
@zuckerberg:neet.spacezuckerberg changed their profile picture.22:02:48
16 Jul 2023
@windchimesofmagic:matrix.org@windchimesofmagic:matrix.org joined the room.02:36:59
17 Jul 2023
@domenkozar:matrix.orgDomen Kožar2023-07-17-120337_917x440_escrotum.png
Download 2023-07-17-120337_917x440_escrotum.png
11:03:44
@domenkozar:matrix.orgDomen Kožar2023-07-17-120427_830x571_escrotum.png
Download 2023-07-17-120427_830x571_escrotum.png
11:04:36
@domenkozar:matrix.orgDomen Kožarquite consistent results over different social media11:05:03
@toonn:matrix.orgtoonn Is that really debatable at this point? It *should* teach about them. It should just also explain that they're still an experimental feature. 12:46:44
@domenkozar:matrix.orgDomen KožarI've seen that the team decided not to touch flakes and I think that's the wrong direction, given what people are using these days.14:39:20
@asymmetric:matrix.dapp.org.ukasymmetricIt is indeed what we agreed upon at the moment, given that they're marked as experimental. We decided to only focus our (limited) energies on what's stable, and to defer to the wider community for when flakes are ready for prime time. There are obvious downsides to this, and different ways to look at the situation (one of them being "harm reduction", i.e. people are already using them, we should teach them how to do it safely), but given that the state of the conversation is what it is, the team opted for having a clearly defined line between what's supported and what isn't14:45:41
@asymmetric:matrix.dapp.org.ukasymmetric * It is indeed what we agreed upon at the moment, given that they're marked as experimental. We decided to only focus our (limited) energies on what's stable, and to defer to the wider community for when flakes are ready for prime time. There are obvious downsides to this, and different ways to look at the situation (one of them being "harm reduction", i.e. people are already using flakes, we should teach them how to do it safely), but given that the state of the conversation is what it is, the team opted for having a clearly defined line between what's supported and what isn't14:47:43
@asymmetric:matrix.dapp.org.ukasymmetric * It is indeed what we agreed upon at the moment, given that they're marked as experimental. We decided to only focus our (limited) energies on what's stable, and to defer to the wider community for when flakes are ready for prime time. There are obvious downsides to this, and different ways to look at the situation (one of them being "harm reduction", i.e. people are already using flakes, we should teach them how to do it safely), but given that the state of the conversation is what it is, the team opted for using stability as the demarcating line between what goes into nix.dev and what doesn't14:48:32
@domenkozar:matrix.orgDomen KožarWe could make it a sprint topic for nixcon :)14:53:00
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @domenkozar:matrix.org
We could make it a sprint topic for nixcon :)
could be an idea 🙂 unfortunately tickets already sold out ☹️
14:55:23
@fricklerhandwerk:matrix.orgfricklerhandwerkI'll be there and I'd rather focus on docs infrastructure, such as setting up better linting and automated tests for examples15:04:27
@fricklerhandwerk:matrix.orgfricklerhandwerk * I'll be there and I'd rather focus on docs infrastructure, such as setting up better linting and automated tests for examples, as that will provide long-term value regardless15:04:44
@infinisil:matrix.orginfinisil Domen Kožar: I really like the idea of "If you want Flakes to be officially documented, work towards its stabilisation" 15:34:42
@infinisil:matrix.orginfinisilIt doesn't make sense to invest a lot of effort into documenting something experimental, but not investing effort into trying to stabilise it15:35:08
@ronef:matrix.orgronef asymmetric: pinged you privately to get this resolved! :) 16:55:02
@domenkozar:matrix.orgDomen Kožar
In reply to @infinisil:matrix.org
It doesn't make sense to invest a lot of effort into documenting something experimental, but not investing effort into trying to stabilise it
Most of Nix users are using flakes and it's not documented, that's what I care about. The stabilization process is something I'm personally not interested to put in the time, I care that our users have docs to use Nix :)
17:11:26
@domenkozar:matrix.orgDomen KožarI'm fine saying it's experimental, etc.17:12:06

Show newer messages


Back to Room ListRoom Version: 6