| 27 Jul 2022 |
 Sandro 🐧 | Why is that issue in nixos-search? That just consumes the metadata. | 13:32:15 |
 Linux Hackerman | because nixos-search is what suggests nix-env -iA nixos.docker | 13:33:03 |
| Sandro 🐧 | at least the meta data changes don't really go well into nixos-search repo | 13:54:02 |
| Sandro 🐧 | also that advice is completely wrong in general and we should just remove it | 13:54:22 |
 dramforever | Agreed. 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 left the room. | 13:21:42 |
| 29 Jul 2022 |
|  jurraca joined the room. | 15:52:12 |
 pennae | 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 |
 Jan Tojnar | I do not think there is much distinction between literal and code | 20:14:48 |
| Jan Tojnar | or rather, the markdown backticks semantically represent inline code, if anything | 20:15:31 |
| Jan Tojnar | and we have already started mushing literals into it | 20:15:52 |
| Jan Tojnar | package, maybe | 20:16:25 |
| pennae | it's not too late to undo all the markdown migrations and add a role for literals if that would be useful | 20:17:55 |
| pennae | we now have the tooling to do this automatically, it wouldn't hurt a whole lot | 20:18:43 |
| Jan Tojnar | I was thinking the other manuals as well | 22:14:49 |
| pennae | that...would be a lot more effort. :/ | 22:38:50 |
| pennae | 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 🐧 changed their display name from Sandro to Sandro 🐧. | 13:17:06 |
| 31 Jul 2022 |
|  Minion3665 joined the room. | 10:11:16 |
|  ruro joined the room. | 21:14:33 |
| 1 Aug 2022 |
|  better_sleeping joined the room. | 09:03:54 |
| better_sleeping left the room. | 09:04:33 |
 fricklerhandwerk | Just 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 |
| pennae | putting the best synthesis in one place sounds good | 13:16:26 |
| 2 Aug 2022 |
| jurraca | probably worth reusing, it's nice and concise
| 14:01:11 |
 fufexan | not sure if this is the proper place to ask, but would it make sense to list the recent Nix 2.10 portability upgrade in the How Nix works page, under Portability? | 14:33:14 |
|  mistermentat joined the room. | 20:08:01 |
| pennae | it is somewhat annoying that markdown is not a hierarchical format. we'll have to somehow forbid eg headings in option docs or the renderers might just produce garbage :/ | 20:40:14 |
| 3 Aug 2022 |
|  Xandor Schiefer joined the room. | 12:53:02 |
| 4 Aug 2022 |
|  Solène Rapenne (she/her) joined the room. | 07:47:29 |
