!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

434 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
21 Jul 2022
@rendakuenthusiast:imperishable.namerendakuenthusiast joined the room.23:20:02
22 Jul 2022
@me:linj.techlinj joined the room.00:06:31
24 Jul 2022
@jkxyz:matrix.orgjkxyz joined the room.18:34:13
26 Jul 2022
@tinybronca:sibnsk.netunderpantsgnome changed their display name from tinybronca to tailrec.14:39:50
@tinybronca:sibnsk.netunderpantsgnome changed their display name from tailrec to tinybronca.16:00:59
27 Jul 2022
@roberthensing:matrix.orgRobert Hensing (roberth)package search has completely wrong documentation for NixOS services https://github.com/NixOS/nixos-search/issues/50609:53:04
@fufexan:matrix.orgfufexanI'd be happy to help with this!10:48:35
@sandro:supersandro.deSandro 🐧Why is that issue in nixos-search? That just consumes the metadata.13:32:15
@linus:schreibt.jetztLinux Hackerman because nixos-search is what suggests nix-env -iA nixos.docker 13:33:03
@sandro:supersandro.deSandro 🐧at least the meta data changes don't really go well into nixos-search repo13:54:02
@sandro:supersandro.deSandro 🐧also that advice is completely wrong in general and we should just remove it13:54:22
@dramforever:matrix.orgdramforeverAgreed. One of the things that might be confusing is that 'install' doesn't mean the same thing as what you'd expect from other package managers, so that's nice to address.15:12:50
28 Jul 2022
@dramforever:matrix.orgdramforever left the room.13:21:42
29 Jul 2022
@starf0x7:matrix.orgjurraca joined the room.15:52:12
@pennae:matrix.eno.spacepennae should we introduce a couple more inline roles for option docs constructs that don't have exact equivalents in markdown yet? <package> and <code> are the most common tags that we can currently only translate as normal code blocks (which turn into <literal>), but distinguishing those three things seems not entirely useful 19:14:23
@jtojnar:matrix.orgJan TojnarI do not think there is much distinction between literal and code20:14:48
@jtojnar:matrix.orgJan Tojnaror rather, the markdown backticks semantically represent inline code, if anything20:15:31
@jtojnar:matrix.orgJan Tojnarand we have already started mushing literals into it20:15:52
@jtojnar:matrix.orgJan Tojnarpackage, maybe20:16:25
@pennae:matrix.eno.spacepennaeit's not too late to undo all the markdown migrations and add a role for literals if that would be useful20:17:55
@pennae:matrix.eno.spacepennaewe now have the tooling to do this automatically, it wouldn't hurt a whole lot20:18:43
@jtojnar:matrix.orgJan TojnarI was thinking the other manuals as well22:14:49
@pennae:matrix.eno.spacepennaethat...would be a lot more effort. :/22:38:50
@pennae:matrix.eno.spacepennae most of the remaining uncoverted docs after https://github.com/NixOS/nixpkgs/pull/183491 are held back by either links that don't round-trip, admonitions, or manpage references. <package> turns up only 46 times while there's hundreds of the roles we've already defined 22:42:40
30 Jul 2022
@sandro:supersandro.deSandro 🐧 changed their display name from Sandro to Sandro 🐧.13:17:06
31 Jul 2022
@minion3665:matrix.orgMinion3665 joined the room.10:11:16
@ruroruro:matrix.orgruro joined the room.21:14:33
1 Aug 2022
@better_sleeping:converser.eubetter_sleeping joined the room.09:03:54
@better_sleeping:converser.eubetter_sleeping left the room.09:04:33
@fricklerhandwerk:matrix.orgfricklerhandwerkJust found that NixOS manual for some reason has a Nix language syntax summary: https://nixos.org/manual/nixos/stable/index.html#sec-nix-syntax-summary That should, if at all, be in the Nix manual. Any objection to just removing it?11:15:23

Show newer messages


Back to Room ListRoom Version: 6