!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

418 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
18 Mar 2024
@rina/:matrix.orgkait
In reply to @johannes.kirschbauer:scs.ems.host
If you could give a concrete example i can tell you if its a wiring issue or would need to be maintained seperately anyways in the long term. I remembered that the writers because some of them are dynamically created by partial application
I am thinking of the functions in this file: https://github.com/NixOS/nixpkgs/blob/8f0d434c23d2ae84d0bf32622358361ade96d077/pkgs/build-support/writers/scripts.nix#L402
07:15:42
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostI think they do. I also started a minimal project that does only the reference tracking https://github.com/hsjobeki/flutsch by value introspection07:30:53
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * I think nixd does. I also started a minimal project that does only the reference tracking https://github.com/hsjobeki/flutsch by value introspection 07:31:59
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host jade_: 07:32:09
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostIts very POC and need more love and time until its usable07:32:56
@jade_:matrix.org@jade_:matrix.org oh nice 07:33:03
@jade_:matrix.org@jade_:matrix.org still thinking it might be a bit challenging to e.g. take a huge trace of nix evaluation that annotates value type info and sources at every position. but it would be so good   07:35:14
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostIts basically how noogle works. (Not via traces, but value introspection)07:38:19
@jade_:matrix.org@jade_:matrix.org but having info inside of functions would sure be useful 07:42:24
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @rina/:matrix.org
I am thinking of the functions in this file: https://github.com/NixOS/nixpkgs/blob/8f0d434c23d2ae84d0bf32622358361ade96d077/pkgs/build-support/writers/scripts.nix#L402

If you'd document them in the same ways as: https://github.com/nixos/nixpkgs/blob/master/lib/lists.nix#L42

We can add them to the index.

08:43:04
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @rina/:matrix.org
I am thinking of the functions in this file: https://github.com/NixOS/nixpkgs/blob/8f0d434c23d2ae84d0bf32622358361ade96d077/pkgs/build-support/writers/scripts.nix#L402
*

If you'd document them in the same ways as: https://github.com/nixos/nixpkgs/blob/master/lib/lists.nix#L42

We can add them to the index. (Wiring should be trivial, i can help with that)

08:43:57
@fricklerhandwerk:matrix.orgfricklerhandwerk Hey docs people and Dominic Mills, how is the application to Google Season of Docs going? It we don’t get anything exciting, we can just apply for writing 2-3 key tutorials. It’s boring but we have precedence that it can work, and we can cheaply measure success by looking at the Google Search dashboard and view statistics 20:43:06
@fricklerhandwerk:matrix.orgfricklerhandwerk * Hey docs people and Dominic Mills, how is the application to Google Season of Docs going? If we don’t get anything exciting, we can just apply for writing 2-3 key tutorials. It’s boring but we have precedence that it can work, and we can cheaply measure success by looking at the Google Search dashboard and view statistics 20:43:21
@dmills27:matrix.orgDominic Mills I've been working it. I got some interesting ideas from danielsidhion and Shahar "Dawn" Or (mightyiam). I'll publish it publicly tomorrow or Wednesday on my Github. 20:45:24
19 Mar 2024
@mjolnir:nixos.orgNixOS Moderation Botchanged room power levels.00:30:57
@danielsidhion:nixos.devdanielsidhionGiven there hasn't been a meeting on a Monday for essentially 2 months now, are you folks ok if I make a PR to say we only meet once a week on the nix.dev readme? Will also need to change the meeting invite on the calendar (I don't have access to it)07:18:20
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @danielsidhion:nixos.dev
Given there hasn't been a meeting on a Monday for essentially 2 months now, are you folks ok if I make a PR to say we only meet once a week on the nix.dev readme? Will also need to change the meeting invite on the calendar (I don't have access to it)
I’ll be back the week after next
08:10:51
@rina/:matrix.orgkait
In reply to @johannes.kirschbauer:scs.ems.host
If you'd document them in the same ways as: https://github.com/nixos/nixpkgs/blob/master/lib/lists.nix#L42 We can add them to the index. (Wiring should be trivial, i can help with that)
thanks! I am fairly busy at the moment but I hope to get to this in the next week or so. (if this should be done sooner, no need to wait for me)
12:26:00
21 Mar 2024
@janejasperous:nadanix.comJane Jasperous set a profile picture.16:34:26
@janejasperous:nadanix.comJane Jasperous changed their profile picture.16:36:57
@mjolnir:nixos.orgNixOS Moderation Botchanged room power levels.18:03:48
@grahamc:nixos.org@grahamc:nixos.org left the room.20:10:20
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @dmills27:matrix.org
I've been working it. I got some interesting ideas from danielsidhion and Shahar "Dawn" Or (mightyiam). I'll publish it publicly tomorrow or Wednesday on my Github.
Updates?
21:23:35
@fricklerhandwerk:matrix.orgfricklerhandwerkBTW I still won't be able to make the meeting next Monday. Next meeting I'll join will be March 28. Would be great if we clarified the GSoD situation until then, it's not that much time left21:53:04
22 Mar 2024
@dmills27:matrix.orgDominic Mills
In reply to @fricklerhandwerk:matrix.org
Updates?
I had some setbacks .i.e. power cuts. I'm aiming to push something out tomorrow.
00:08:39
@ibizaman:matrix.orgibizamanhi 👋 I had an idea, what do you all think about "translating" the Archlinux install wiki to NixOS? Would be called something like "Arch Install Guide for NixOS". Essentially https://wiki.archlinux.org/title/Installation_guide but with all commands and instructions replaced by their NixOS equivalent? I think it's a good idea because I always found the Arch wiki pretty complete.05:07:03
@ibizaman:matrix.orgibizaman * hi 👋 I had an idea, what do you all think about "translating" the Archlinux install wiki to NixOS? Would be called something like "Arch Install Guide for NixOS". Essentially https://wiki.archlinux.org/title/Installation_guide but with all commands and instructions replaced by their NixOS equivalent? I think it's a good idea because I always found the Arch wiki pretty complete. I don't have a timeline to work on this but was already wondering if ppl found this to be a good idea. 05:07:39
@t3rminal-filth:matrix.orgterminalfilth joined the room.05:14:12
@t3rminal-filth:matrix.orgterminalfilth set a profile picture.05:24:36
@t3rminal-filth:matrix.orgterminalfilth changed their profile picture.05:24:46

Show newer messages


Back to Room ListRoom Version: 6