!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

434 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

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


SenderMessageTime
3 Oct 2023
@infinisil:matrix.orginfinisil asymmetric: Manual backport would be doable 09:28:19
@asymmetric:matrix.dapp.org.ukasymmetrichmm, we'd have to backport the whole nrd thing though as well, but yes doable. not sure if we'd end up with a frankenstein manual though, i'd need to be careful to include all patches that changed it? or do you have some other idea in mind?09:29:40
@infinisil:matrix.orginfinisil asymmetric: If it's not easy let's not do it 10:00:56
@infinisil:matrix.orginfinisilNot worth it :)10:01:05
5 Oct 2023
@zmitchell:matrix.org@zmitchell:matrix.orghttps://discourse.nixos.org/t/this-month-in-nix-docs-5-september-2023/3385601:37:32
@zmitchell:matrix.org@zmitchell:matrix.org
In reply to @asymmetric:matrix.dapp.org.uk
I would also mention this new chapter and use the opportunity to say that if anyone feels like bringing the platform support tier list from the RFC up to date and add it to the manual, they’re more than welcome and would be pretty nice
I missed this, please add a comment to the post so it’s not overlooked!
05:15:06
@alejandrosame:matrix.orgalejandrosameI won't be joining today. I'll be in transit at the time of the meeting.13:21:28
6 Oct 2023
@olafklingt:matrix.org@olafklingt:matrix.orgwhat prevents this pr from being reviewed or merged? https://github.com/NixOS/nix.dev/pull/72513:24:26
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @olafklingt:matrix.org
what prevents this pr from being reviewed or merged? https://github.com/NixOS/nix.dev/pull/725
It’s in my queue that’s way too long. Sorry for the unbounded delay. I’ll take care of it later today.
16:05:54
9 Oct 2023
@b:chreekat.netchreekat changed their display name from chreekat to chreekat (afk, admin day).10:19:11
@i97henka:matrix.orghenrik-chsorry, no doc meeting for me today - have a good session!13:32:11
@kidsan:matrix.orgkidsan joined the room.14:02:14
@mightyiam:matrix.org@mightyiam:matrix.orgUpdate from me: working in some capacity on releasing a doctester.14:15:00
@zhenbo:matrix.orgzhenbo joined the room.21:55:51
10 Oct 2023
@niahex:matrix.orgNia joined the room.05:16:03
@b:chreekat.netchreekat changed their display name from chreekat (afk, admin day) to chreekat.11:39:20
@alejandrosame:matrix.orgalejandrosame Today I managed to work on \https://github.com/NixOS/nix.dev/pull/515 19:42:41
@alejandrosame:matrix.orgalejandrosame * Today I managed to work on https://github.com/NixOS/nix.dev/pull/51519:42:46
11 Oct 2023
@fricklerhandwerk:matrix.orgfricklerhandwerk

https://github.com/stepchowfun/tagref

This is an interesting idea. Never mind the particular implementation. It seems like one could hack together some simple pre- or post-processing to allow for linking to code locations across source type boundaries in rendered documentation.

04:04:35
@asymmetric:matrix.dapp.org.ukasymmetric note that an alternative approach is literate programming, e.g. org-mode + babel. in org-mode you can easily link to other notes (or specific sections of notes). 10:48:18
@asymmetric:matrix.dapp.org.ukasymmetric

is anyone actively working on documenting the module system? I know about existing efforts, and i vaguely remember proofconstruction working on this, but what's the current status?

i'd be interested in taking on some of this work.

10:49:25
@teoc:matrix.orgTeo (he/him) changed their display name from Teo (he/they) to teo (they/he).15:54:50
12 Oct 2023
@proofconstruction:matrix.orgproofconstruction
In reply to @asymmetric:matrix.dapp.org.uk

is anyone actively working on documenting the module system? I know about existing efforts, and i vaguely remember proofconstruction working on this, but what's the current status?

i'd be interested in taking on some of this work.

infinisil dumped notes and git commits https://github.com/NixOS/nix.dev/pull/645 from a previous summer of nix presentation, which i've massaged into something tutorial-like https://github.com/NixOS/nix.dev/pull/730. i've just completed a big move and started a new gig, so very scattered (more than usual for me!) currently, but somewhere i have notes towards a much shorter introduction (silvan's presentation became like 1200 lines of tutorial, way too big for a single page)
04:07:21
@b:chreekat.netchreekat changed their display name from chreekat to chreekat (afk, sick).08:03:25
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk

is anyone actively working on documenting the module system? I know about existing efforts, and i vaguely remember proofconstruction working on this, but what's the current status?

i'd be interested in taking on some of this work.

There are 1-2 open PRs to the Nixpkgs manual by Robert Hensing (roberth)
08:20:23

Show newer messages


Back to Room ListRoom Version: 6