Nix Documentation | 447 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 92 Servers |
| Sender | Message | Time |
|---|---|---|
| 10 May 2023 | ||
| Okay, interesting, I've been to nix.dev before, but I didn't know it was official (due to the reasons you pointed out). And also, if that's the place where something like "How to configure a printer" would belong, the title and the subtitle "An opinionated guide for developers getting things done using the Nix ecosystem." should probably also be changed, but I'm not quite sure to what? What exactly would it be, if it's neither the manual nor the wiki and what would it be called? "NixOS Guides"? What would a nixos.org subdomain be? guides.nixos.org? | 09:29:42 | |
| And yeah, I was thinking about joining one of the meetings when I find the time 👍️ | 09:30:13 | |
In reply to @asymmetric:matrix.dapp.org.ukWe're waiting for the NixOS Foundation to receive ownership of Copyright and the domain. | 10:14:30 | |
In reply to @asymmetric:matrix.dapp.org.uk* We're waiting for the NixOS Foundation to receive ownership of copyright and the domain. Technical issues can be fixed quickly. | 10:14:39 | |
In reply to @asymmetric:matrix.dapp.org.uk It's not exactly that simple. What we really need is a clearly distinct presentation for the different ecosystem components (Nix, Nixpkgs, NixOS, and possibly others), and one integrated user story. Currently we have no maintainers for NixOS documentation, but ironically this is what most new users come from and end up confused. nixos.org contains very little technical information and is more of an organisational hub, at least judging from where the updates are happening. nix.dev is trying to do the integration. More context: https://github.com/NixOS/nix.dev/issues/290 I think we do have a clear vision what needs to be done, but lack of resources and problems with coordination to actually do it. | 10:21:28 | |
In reply to @asymmetric:matrix.dapp.org.uk* It's not exactly that simple. What we really need is a clearly distinct presentation for the different ecosystem components (Nix, Nixpkgs, NixOS, and possibly others), and one integrated user story. Currently we have no maintainers for NixOS documentation, but ironically this is what most new users come from and end up confused with. nixos.org contains very little technical information and is more of an organisational hub, at least judging from where the updates are happening. nix.dev is trying to do the integration. More context: https://github.com/NixOS/nix.dev/issues/290 I think we do have a clear vision what needs to be done, but lack of resources and problems with coordination to actually do it. | 10:22:01 | |
| * It's not exactly that simple. What we really need is a clearly distinct presentation for the different ecosystem components (Nix, Nixpkgs, NixOS, and possibly others), and one integrated user story. Currently we have no maintainers for NixOS documentation, but ironically this is what most new users come for and end up confused with. nixos.org contains very little technical information and is more of an organisational hub, at least judging from where the updates are happening. nix.dev is trying to do the integration. More context: https://github.com/NixOS/nix.dev/issues/290 I think we do have a clear vision what needs to be done, but lack of resources and problems with coordination to actually do it. | 10:22:08 | |
In reply to @fricklerhandwerk:matrix.orgWho's doing that, what's the status? This doesn't seem to have moved along at all within months | 10:30:54 | |
| Okay, so nix.dev is supposed to become a kind of central documentation hub? | 10:40:01 | |
| And regarding my original question about "where to put 'how to set up printing' and other stuff that currently lives in the wiki" – I'm still a little confused, because looking over the current version of nix.dev something like that would look very much out of place there | 10:43:05 | |
In reply to @eisfunke:eisfunke.comyeah that's an interesting point and i admit i haven't thought about this kind of content in relation to nix.dev ... not sure if the others have | 10:47:52 | |
In reply to @eisfunke:eisfunke.com* yeah that's an interesting point and i admit i haven't thought much about this kind of content in relation to nix.dev ... not sure if the others have | 10:48:00 | |
https://nix.dev/contributing/documentation#wiki | 11:59:16 | |
In reply to @infinisil:matrix.org Domen Kožar and the foundation board have to do this. I know that Théophane has looked into it somewhat recently. But board members are extremely time-constrained and have lots of things on their plate. ronef could you prioritise this? We’re running into this problem continuously, and it would unblock a lot of things we wanted to do for a long time now. | 12:13:03 | |
| that's all done | 12:13:57 | |
| transferred the domain yesterday and signed the copyright transfer about a month ago | 12:14:11 | |
| 12:22:00 | ||
In reply to @domenkozar:matrix.org Awesome! I didn’t even know. Did you publish it in the board meeting notes somewhere? Couldn’t find it. asymmetric: Since that’s settled, please go ahead with the necessary updates. I will bring these two old PRs up to date this week: https://github.com/NixOS/nix.dev/pull/262 https://github.com/NixOS/nixos-homepage/pull/882 | 12:55:00 | |
| Just acking that it's resolved :) | 16:39:29 | |
In reply to @infinisil:matrix.orgzmitchell: As already hinted at, I won't be there in this weeks learning journey WG meeting due to a conflict. | 23:00:39 | |
| 11 May 2023 | ||
| If anyone finds the magic Discourse thread for invitations to the NixOS Github org, please let me know so I can bookmark it. I wasn't able to find it. | 15:16:07 | |
| there's none for org invites, just for nixpkgs-committers invites | 15:17:16 | |
| and that's on github 😬 | 15:17:25 | |
| org invites happen automatically though for new entries in maintainers.nix, so no thread is needed | 15:17:57 | |
| There are people on the Docs Team that need invites to the org so they can be made a part of the Docs Team and LJWG GitHub Teams, does it make sense for people to be added to maintainers.nix in that case? | 15:18:49 | |
| They should probably be separately added to the org | 15:19:54 | |
| We can have a different team for that | 15:20:05 | |
| (or I guess, we do already) | 15:20:36 | |
| I would ask domenkozar about it | 15:20:38 | |
| the docs team does maintain docs, so we'd not be too picky about that bit if no better process is forthcoming | 15:22:33 | |