!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

438 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
29 Jul 2022
@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
@pennae:matrix.eno.spacepennaeputting the best synthesis in one place sounds good13:16:26
2 Aug 2022
@starf0x7:matrix.orgjurracaprobably worth reusing, it's nice and concise 14:01:11
@fufexan:matrix.orgfufexan 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:matrix.orgmistermentat joined the room.20:08:01
@pennae:matrix.eno.spacepennaeit 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
@zeorin:matrix.orgXandor Schiefer joined the room.12:53:02
4 Aug 2022
@rapenne-s:tchncs.deSolène Rapenne (she/her) joined the room.07:47:29
@rapenne-s:tchncs.deSolè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
@rapenne-s:tchncs.deSolè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 install07:49:19
@fricklerhandwerk:matrix.orgfricklerhandwerk

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
@linus:schreibt.jetztLinux 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
@rapenne-s:tchncs.deSolène Rapenne (she/her)using search.nixos.org may be the good way07:55:38
@linus:schreibt.jetztLinux Hackerman or the classic nix-env -qaP 07:55:52
@rapenne-s:tchncs.deSolène Rapenne (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:matrix.orgfricklerhandwerk

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:matrix.orgfricklerhandwerk *

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
@rapenne-s:tchncs.deSolène Rapenne (she/her)that seems good!08:46:26
@fricklerhandwerk:matrix.orgfricklerhandwerk Solène (she/her): would you like to write a quick draft on the Wiki? 08:54:01
@rapenne-s:tchncs.deSolène Rapenne (she/her)sure08:54:14
@rapenne-s:tchncs.deSolène Rapenne (she/her) this is a start for the wiki https://nixos.wiki/wiki/Searching_packages 09:25:58
@hexa:lossy.networkhexaI wonder whether an example for a network configuration using networkd would be appreciated in the sample configuration.nix10:49:59
@hexa:lossy.networkhexato move the sorry state that of people using the scripted networking bits10:50:56

Show newer messages


Back to Room ListRoom Version: 6