!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

442 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
9 Apr 2023
@pennae:matrix.eno.spacepennaeyes14:06:38
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Ah. Okay. But youā€˜d still need lsp support :P šŸ˜‰ the lsp would auto-start the next line with # then. 14:07:45
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Or you had to do it manually 14:08:03
@pennae:matrix.eno.spacepennaebut..that would be the correct thing to do?14:08:20
@pennae:matrix.eno.spacepennae we may have misunderstood you, but we'd write #| foo\n# bar 14:08:42
@toonn:matrix.orgtoonn changed their profile picture.14:12:17
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Ye good point.
I think it might be wise to have you read the rfc first.. i didn’t propose two different formats. There are only doc-comments for the next expression; not the previous. I thought it would just work fine, no need for the complexity.
But maybe we need think about this a little. And also bring support for backwards reference.
In rust the only thing where this is used is at the top of a file. But in nix a file can only export one single expression; multiple expressions is just not possible. Thats why i thought we dont need backwards reference
14:19:24
10 Apr 2023
@0xmrtt:envs.net@0xmrtt:envs.net joined the room.09:25:08
@9hp71n:matrix.org@9hp71n:matrix.org left the room.17:52:36
11 Apr 2023
@thecodedkid:matrix.orgthecodedkid set a profile picture.01:09:17
@fricklerhandwerk:matrix.orgfricklerhandwerk Johannes Kirschbauer (@hsjobeki): we briefly discussed the RFC in the docs team meeting today, trying to sort out the exact problems it's trying to address and assess the proposals with respect to that. infinisil asymmetric and me want to take time to read the RFC properly, each on our own. My first impression is that it tries to do multiple things at once (at least: a syntax for distinguishing doc comments, and the internal structure of doc comments), and that makes it somewhat hard to focus the discussion. 12:12:51
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host fricklerhandwerk: Thanks for the feedback. It would be nice, if both concerns could be solved in that single RFC. However if that is already to much, it might make sense to break that RFC into two even smaller independent RFCs.
Although i'd argue hat both concerns (outer-format & inner-format) are somewhat closely related to each other. Thus it might make sense to address both at once.
can you send me an invite for the next meetup on Thursday?
12:20:09
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * fricklerhandwerk: Thanks for the feedback.
It would be nice, if both concerns could be solved in that single RFC. However if that is already to much, it might make sense to break that RFC into two even smaller independent RFCs.
Although i'd argue hat both concerns (outer-format & inner-format) are somewhat closely related to each other. Thus it might make sense to address both at once.
can you send me an invite for the next meetup on Thursday?
12:20:16
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * fricklerhandwerk: Thanks for the feedback.
It would be nice, if both concerns could be solved in that single RFC. However if that is already to much, it might make sense to break that RFC into two even smaller independent RFCs.
Although i'd argue that both concerns (outer-format & inner-format) are somewhat closely related to each other. Thus it might make sense to address both at once.
can you send me an invite for the next meetup on Thursday?
12:27:26
@asymmetric:matrix.dapp.org.ukasymmetric Johannes Kirschbauer (@hsjobeki): its' this one https://discourse.nixos.org/t/community-calendar/18589/61 13:01:07
@ronef:matrix.orgronefNix foundation will also join the docs funding via the NixOS funding program with 1k :) 16:31:17
@infinisil:matrix.orginfinisil ronef: What's the Nix foundation? 16:50:45
@figsoda:matrix.orgfigsodaNixOS foundation I'm assuming?16:51:51
@asymmetric:matrix.dapp.org.ukasymmetrici've added this issue to the board: https://github.com/NixOS/nixpkgs/pull/142282 the context is here (also see one message above/below): https://github.com/NixOS/nixpkgs/issues/102397#issuecomment-149505946317:59:01
@i97henka:matrix.orghenrik-ch changed their display name from i97henka to henrik-ch.20:17:08
@ronef:matrix.orgronef
In reply to @infinisil:matrix.org
ronef: What's the Nix foundation?
NixOS Foundation** :)
21:58:15
12 Apr 2023
@errisnotnil:matrix.orgYuddite G joined the room.09:12:04
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @ronef:matrix.org
NixOS Foundation** :)
https://github.com/NixOS/foundation/issues/77
09:29:31
@b:chreekat.netchreekat changed their display name from chreekat (afk) to chreekat.10:36:46
@andi:kack.itandi- changed their display name from andi- to andi-|m.10:38:27
@andi:kack.itandi- changed their display name from andi-|m to andi-.13:00:47
@nixinator:nixos.dev@nixinator:nixos.dev You mean the nix/OS foundation . That should cover all bases. 13:29:08
@j-k:matrix.orgj-kGNU + nix/OS/lang + Community & friends - foundation™®14:58:10
13 Apr 2023
@nixinator:nixos.dev@nixinator:nixos.dev
In reply to @j-k:matrix.org
GNU + nix/OS/lang + Community & friends - foundation™®
We have a winner
10:38:04
@nixinator:nixos.dev@nixinator:nixos.dev
In reply to @nixinator:nixos.dev
We have a winner
Catchy too ;-)
10:38:26

Show newer messages


Back to Room ListRoom Version: 6