2 Jul 2024 |
Johannes Kirschbauer @hsjobeki | Who got commit rights and would like to review a 2k lines changed pr? 😬
https://github.com/NixOS/nixpkgs/pull/323843/files | 15:36:41 |
Johannes Kirschbauer @hsjobeki | Should i split it? | 15:38:11 |
Johannes Kirschbauer @hsjobeki | * Who got commit rights and/or would like to review a 2k lines changed pr? 😬
https://github.com/NixOS/nixpkgs/pull/323843/files | 16:05:39 |
djacu | I don't have commit rights but taking a look.
I'm seeing some things that I can't find in RFC 145. Was the format updated in a another RFC? | 16:12:00 |
fricklerhandwerk | I can take a look this week, and merge some little fixups on the way | 16:15:49 |
fricklerhandwerk | Overall it's not that bad, looks pretty mechanical | 16:16:02 |
fricklerhandwerk | * Overall it's not that bad in terms of size, looks pretty mechanical. | 16:16:12 |
Johannes Kirschbauer @hsjobeki | djacu: no the RFC is not strict in those terms. danielsidhion and me worked on what is more like conventions. There are other files in lib that use commonmark already in comments for reference | 16:29:54 |
Johannes Kirschbauer @hsjobeki | In reply to @fricklerhandwerk:matrix.org Overall it's not that bad in terms of size, looks pretty mechanical. Yeah just spent some hours sundays to go through all of those little things | 16:31:17 |
djacu | In reply to @johannes.kirschbauer:scs.ems.host djacu: no the RFC is not strict in those terms. danielsidhion and me worked on what is more like conventions. There are other files in lib that use commonmark already in comments for reference Ah okay. I saw things like this and wasn't sure.
# Inputs
`f`
: 1\. Function argument
I do like it though!
| 17:28:37 |
4 Jul 2024 |
| Philip Taron (UTC-8) left the room. | 15:46:27 |
| Philip Taron (UTC-8) joined the room. | 15:56:12 |
| Benedikt changed their display name from Soispha to Benedikt. | 19:10:58 |
5 Jul 2024 |
| Dennis joined the room. | 20:18:47 |
| Sami Liedes joined the room. | 23:03:10 |
Sami Liedes | Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.
Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation
I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least
- Sort it; now it's hard to find anything in it
- I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.
Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, flake, home manager.
Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)
| 23:11:29 |
Sami Liedes | * Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.
Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation
I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least
- Sort it; now it's hard to find anything in it
- I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.
Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, generation, flake, home manager.
Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)
| 23:14:56 |
Sami Liedes | * Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.
Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation
I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least
- Sort it; now it's hard to find anything in it
- I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.
Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, generation, channel, flake, home manager.
Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)
| 23:18:38 |
Sami Liedes | When trying to get stuff to work, I've ran a lot into something like "here's a flake you can use" or "if you use home manager, you can do this". I have been able to figure out that I don't use home manager, and perhaps should wait until I'm a bit more comfortable with Nix. The flake thing is a bit more obscure to me. It seems to be either an extension of the nix command, external repositories for Nix packages (derivations?), or some overarching system to enable all of the above that goes above configuration.nix. :D
(Not looking for an explanation of what it is here, but trying to convey the confusion!) | 23:21:20 |
6 Jul 2024 |
fricklerhandwerk | Hi Sami Liedes and welcome to the community! We’ve spent quite some effort to make the first steps with Nix smooth and orient people in the ecosystem. NixOS is only one - of course important - part of that, and despite it’s great benefits it can be considered an advanced use case. | 10:12:23 |
fricklerhandwerk | Here’s a concise overview of all the big things that have Nix in their name: https://nix.dev/reference/glossary | 10:12:39 |
fricklerhandwerk | Each of those things has a reference manual, all of them linked in nix.dev. The reference manuals are supposed to only show what’s there, with a few examples, while nix.dev is for tutorials and guides. The separation is not as clean in reality, because there are a lot of pieces to the puzzle, and the time people spent so far was not enough to untangle everything.
Home Manager is unfortunately not listed there yet, and the only reason is that no one got to explain, within the narrative arc we’re building, which role it plays and how to start out. | 10:17:26 |
fricklerhandwerk | There's the official, actively maintained NixOS wiki at wiki.nixos.org. Together with the NixOS reference manual is where most NixOS documentation lives. But it's very thin altogether, so it should be easy to add useful things as you find them. | 10:23:28 |
fricklerhandwerk | NixOS documentation does not have all that many helping hands, and the user-facing tools are not in great shape, in my opinion. So there are still endless misconceptions implanted into beginners' minds. If you have the time to dig into it and read the source code, I'm there to answer any questions you may encounter, or point you to better places where to ask them. | 10:25:31 |
fricklerhandwerk | As for flakes, here's an overview: https://nix.dev/concepts/flakes | 10:26:18 |