!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

447 Members
Discussion about documentation improvements around the Nix ecosystem92 Servers

Load older messages


SenderMessageTime
10 May 2023
@eisfunke:eisfunke.com@eisfunke:eisfunke.com

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
@eisfunke:eisfunke.com@eisfunke:eisfunke.comAnd yeah, I was thinking about joining one of the meetings when I find the time 👍️09:30:13
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk

fricklerhandwerk: do you know what's blocking us from making nix.dev look more official? Thinking of things like:

  • copyright footer mentioning Domen Kožar
  • style being different
  • lack of link from nixos.org
  • no mention of it being official in landing page
We're waiting for the NixOS Foundation to receive ownership of Copyright and the domain.
10:14:30
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk

fricklerhandwerk: do you know what's blocking us from making nix.dev look more official? Thinking of things like:

  • copyright footer mentioning Domen Kožar
  • style being different
  • lack of link from nixos.org
  • no mention of it being official in landing page
* We're waiting for the NixOS Foundation to receive ownership of copyright and the domain. Technical issues can be fixed quickly.
10:14:39
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk
so if there are blockers around copyright transfer of nix.dev, this could be a way to sidestep those entirely, and solve visiblity from homepage and pagerank issues as well

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
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk
so if there are blockers around copyright transfer of nix.dev, this could be a way to sidestep those entirely, and solve visiblity from homepage and pagerank issues as well
*

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

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
@infinisil:matrix.orginfinisil
In reply to @fricklerhandwerk:matrix.org
We're waiting for the NixOS Foundation to receive ownership of copyright and the domain. Technical issues can be fixed quickly.
Who's doing that, what's the status? This doesn't seem to have moved along at all within months
10:30:54
@eisfunke:eisfunke.com@eisfunke:eisfunke.comOkay, so nix.dev is supposed to become a kind of central documentation hub?10:40:01
@eisfunke:eisfunke.com@eisfunke:eisfunke.comAnd 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 there10:43:05
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @eisfunke:eisfunke.com
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
yeah 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
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @eisfunke:eisfunke.com
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
* 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
@j-k:matrix.orgj-k
Where to migrate what:

    Nix interaction: nix manual

    Language-specific build instructions: nixpkgs manual

    Package, service, or hardware configuration: nixos manual

    Overviews, tutorials, guides, and best practices: nix.dev

https://nix.dev/contributing/documentation#wiki

11:59:16
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @infinisil:matrix.org
Who's doing that, what's the status? This doesn't seem to have moved along at all within months

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
@domenkozar:matrix.orgDomen Kožarthat's all done12:13:57
@domenkozar:matrix.orgDomen Kožartransferred the domain yesterday and signed the copyright transfer about a month ago12:14:11
@mrcjk:matrix.orgMarc Jakobi changed their profile picture.12:22:00
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @domenkozar:matrix.org
transferred the domain yesterday and signed the copyright transfer about a month ago

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
@ronef:matrix.orgronefJust acking that it's resolved :) 16:39:29
@infinisil:matrix.orginfinisil
In reply to @infinisil:matrix.org
Though it was moved to the same time as the learning journey meeting on Thursday..
zmitchell: 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
@zmitchell:matrix.org@zmitchell:matrix.orgIf 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
@pennae:matrix.eno.spacepennaethere's none for org invites, just for nixpkgs-committers invites15:17:16
@pennae:matrix.eno.spacepennaeand that's on github 😬15:17:25
@pennae:matrix.eno.spacepennaeorg invites happen automatically though for new entries in maintainers.nix, so no thread is needed15:17:57
@zmitchell:matrix.org@zmitchell:matrix.orgThere 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
@qyliss:fairydust.spaceAlyssa RossThey should probably be separately added to the org15:19:54
@qyliss:fairydust.spaceAlyssa RossWe can have a different team for that15:20:05
@qyliss:fairydust.spaceAlyssa Ross(or I guess, we do already)15:20:36
@qyliss:fairydust.spaceAlyssa RossI would ask domenkozar about it15:20:38
@pennae:matrix.eno.spacepennaethe docs team does maintain docs, so we'd not be too picky about that bit if no better process is forthcoming15:22:33

Show newer messages


Back to Room ListRoom Version: 6