!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

434 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
1 Aug 2022
@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
@hexa:lossy.networkhexa * to move the sorry state. that alot of people us the scripted networking bits, along10:51:11
@rapenne-s:tchncs.deSolène Rapenne (she/her)actually using the nix repl isn't that bad, any other idea for a way to search a package? In the wiki I'd prefer to avoid the "nix search" experimental command that has to be run near a flake.nix file12:31:37
@a-kenji:matrix.orga-kenji
In reply to @rapenne-s:tchncs.de
actually using the nix repl isn't that bad, any other idea for a way to search a package?
In the wiki I'd prefer to avoid the "nix search" experimental command that has to be run near a flake.nix file
You don't need to run it near a flake.nix file, or?
12:32:29
@rapenne-s:tchncs.deSolène Rapenne (she/her)
> nix search
path '/home/solene' does not contain a 'flake.nix', searching up
error: could not find a flake.nix file
12:32:51
@minion3665:matrix.orgMinion3665
In reply to @rapenne-s:tchncs.de
actually using the nix repl isn't that bad, any other idea for a way to search a package?
In the wiki I'd prefer to avoid the "nix search" experimental command that has to be run near a flake.nix file
Nix search doesn't need a flake.nix file
You can run nix search nixpkgs packagename and it'll search in the nixpkgs flake
12:32:52
@rapenne-s:tchncs.deSolène Rapenne (she/her) that's pretty cool, nix --extra-experimental-features "nix-command flakes" search nixpkgs firefox 12:33:57
@minion3665:matrix.orgMinion3665
In reply to @rapenne-s:tchncs.de
that's pretty cool, nix --extra-experimental-features "nix-command flakes" search nixpkgs firefox
Yep
That'll work :)
12:34:32
@rapenne-s:tchncs.deSolène Rapenne (she/her)it's just too bad it needs to download 30MB every so often :D12:34:51

Show newer messages


Back to Room ListRoom Version: 6