| 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 |
| Solène Rapenne (she/her) | hi! I found this comment in the nixos installer to be disturbing: https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/installer/tools/tools.nix#L188
This commands requires flakes to be enabled :/ | 07:48:19 |
| Solène Rapenne (she/her) | I've also seen users trying to use this command to find packages names of the software they wanted in their first NixOS install | 07:49:19 |
| fricklerhandwerk | Solène (she/her): what would you propose? some obvious options:
- instead direct people to search.nixos.org
- add the experimental flag
| 07:54:51 |
 Linux Hackerman | In reply to @rapenne-s:tchncs.de
hi! I found this comment in the nixos installer to be disturbing: https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/installer/tools/tools.nix#L188
This commands requires flakes to be enabled :/ not only that but it doesn't actually work :| | 07:55:22 |
| Solène Rapenne (she/her) | using search.nixos.org may be the good way | 07:55:38 |
| Linux Hackerman | or the classic nix-env -qaP | 07:55:52 |
