| 29 Jul 2022 |
 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 (she/her) joined the room. | 07:47:29 |
| Solène (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 (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 (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 |
| Solène (she/her) | what's sure is the current example is not good 😅 nix-env -qaP is extremely slow and requires a lot of memory, I don't think it's a good idea | 08:04:16 |
| fricklerhandwerk | Solène (she/her) Linux Hackerman What about this:
- make a NixOS Wiki page on searching packages, show all the possibilities, explain the trade-offs
- choose a recommended way of doing things, note reasons
- prepare an issue on github.com/NixOS/nix.dev for the documentation
- roll out the recommendation at the relevant points of interaction, e.g. the
configuration.nix template, nix.dev, nixos.wiki
| 08:44:48 |
| fricklerhandwerk | * Solène (she/her) Linux Hackerman What about this:
-
make a NixOS Wiki page on searching packages, show all the possibilities, explain the trade-offs
-
choose a recommended way of doing things, note reasons
- prepare an issue on github.com/NixOS/nix.dev for the documentation team to shepherd the the discussion
-
roll out the recommendation at the relevant points of interaction, e.g. the configuration.nix template, nix.dev, nixos.wiki
| 08:45:10 |
| Solène (she/her) | that seems good! | 08:46:26 |
