!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

395 Members
Discussion about documentation improvements around the Nix ecosystem79 Servers

Load older messages


SenderMessageTime
22 Feb 2024
@hx-markus:matrix.orghx-markus joined the room.12:26:35
@jvns:matrix.orgb0rk joined the room.17:39:33
23 Feb 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk

Dominic Mills: Here’s another small-scale project for GSoD: Go over existing tutorials on nix.dev and add tags to improve search engine visibility. We know it’s a problem; people mostly find third party stuff because it has been around longer. I’ve seen the Google dashboard.

In fact, anyone can do any subset of that right now. It’s boring and tedious, so if it doesn’t happen by volunteer effort it may happen with a subsidy.

12:06:56
@fricklerhandwerk:matrix.orgfricklerhandwerk *

Dominic Mills: Here’s another small-scale project for GSoD: Go over existing tutorials on nix.dev and add tags to improve search engine visibility. We know it’s a problem; people mostly find third party stuff because it has been around longer. I’ve seen the Google dashboard - ranking is not great.

In fact, anyone can do any subset of that right now. It’s boring and tedious, so if it doesn’t happen by volunteer effort it may happen with a subsidy.

12:07:34
@dooy:matrix.org@dooy:matrix.orgI am wondering if there's a specific strategy for organizing tags from general to specific topics, like to be more consistent with naming? 16:33:40
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @dooy:matrix.org
I am wondering if there's a specific strategy for organizing tags from general to specific topics, like to be more consistent with naming?
I suggest starting with something more simple-minded and just write something down at all, in order to figure out which topics even warrant a tag and what to call it.
17:42:52
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @dooy:matrix.org
I am wondering if there's a specific strategy for organizing tags from general to specific topics, like to be more consistent with naming?
* I suggest starting with something more simple-minded and just write something down at all, in order to figure out which topics even warrant a tag and what to call them.
17:43:11
24 Feb 2024
@olafklingt:matrix.org@olafklingt:matrix.orgis this linkcheck error for PRs deterministic? have you seen it and do you have already an idea what to do about it? https://github.com/NixOS/nix.dev/actions/runs/8023716642/job/21944512721?pr=92123:15:22
25 Feb 2024
@danielsidhion:nixos.devdanielsidhionI just did a re-run and it seems like a real issue, I opened an issue about it02:33:33
@lurkki:pikaviestin.fiLurkki Noticed makeDesktopItem is undocumented, in which section in the manual should it go? 10:27:13
@danielsidhion:nixos.devdanielsidhionIf you want to use an existing section, "trivial build helpers" is probably the best one to put it in. If we were to create a new section, what sort of things would you like to group together with it (so we can figure out a better section name)?11:27:57
@lurkki:pikaviestin.fiLurkki Not sure about grouping, since I'm unfamiliar with most of pkgs/build-support 12:14:35
26 Feb 2024
@infinisil:matrix.orginfinisil Shahar "Dawn" Or (mightyiam): Could you consider changing the name from eelco to something else? It doesn't feel right to use a person's name as a project name in general, but especially if that person is very well-known in the community already. 20:06:28
@infinisil:matrix.orginfinisil * Shahar "Dawn" Or (mightyiam): Could you consider changing the name from eelco (also via nix.dev) to something else? It doesn't feel right to use a person's name as a project name in general, but especially if that person is very well-known in the community already. 20:08:07
27 Feb 2024
@mightyiam:matrix.org@mightyiam:matrix.orgIf Eelco is not offended then we're golden, aren't we?00:00:32
@infinisil:matrix.orginfinisil Shahar "Dawn" Or (mightyiam): That's definitely a requirement, but that wouldn't make it a better choice 01:26:04
@infinisil:matrix.orginfinisilIt leads to cases like if you say "I'd like to introduce <name>", you'd have to explain that it's actually some_thing_, not the person that everybody knows already. Or if somebody says "Have you tried <name>?" it sounds really weird if somebody isn't aware that the project <name> is a thing01:28:26
@asymmetric:matrix.dapp.org.ukasymmetrici personally just find it a bit in poor taste.. seems unnecessary targeting of an individual with a joke that might make them (or other people) feel uncomfortable, for imho no apparent gain09:00:23
@jade_:matrix.org@jade_:matrix.org
In reply to @mightyiam:matrix.org
If Eelco is not offended then we're golden, aren't we?
the minute i even mentioned it i had to clarify because it's incredibly confusing
09:05:20
@dooy:matrix.org@dooy:matrix.orgIf it helps I was confused and wondered if Eelco is in Thailand13:39:19
@chococandy:matrix.orgtrinity changed their display name from chococandy to trinity.14:20:35
@infinisil:matrix.orginfinisil Johannes Kirschbauer @hsjobeki: Do you want write access to nixdoc? It's probably not necessary, but I'd be happy to add you, since your PR was very high quality :) 19:02:25
28 Feb 2024
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @infinisil:matrix.org
Johannes Kirschbauer @hsjobeki: Do you want write access to nixdoc? It's probably not necessary, but I'd be happy to add you, since your PR was very high quality :)
Maybe yes. I think this could help speed up the rfc migration.
10:27:14
@kranurag7:matrix.orgkranurag7 removed their profile picture.10:54:59
29 Feb 2024
@i97henka:matrix.orghenrik-ch Sorry, no doc meeting for me this afternoon - some family stuff to attend to. I still very much want to be part of the team. 13:15:23
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Is the doc team aware that docs for lib.fixedPoints.composeExtension are broken in unstable?
https://nixos.org/manual/nixpkgs/unstable/#function-library-example-lib.fixedPoints.extends
(I cannot directly link to it anymore)
14:03:21
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Is the doc team aware that docs for lib.fixedPoints.composeExtension are broken in unstable?
https://nixos.org/manual/nixpkgs/unstable/#function-library-example-lib.fixedPoints.extends
(I cannot directly link to it anymore, because rendering broke)
14:03:41
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Is the doc team aware that docs for lib.fixedPoints.composeExtension and the following items there are broken in unstable?
https://nixos.org/manual/nixpkgs/unstable/#function-library-example-lib.fixedPoints.extends
(I cannot directly link to it anymore, because rendering broke)
14:05:15
@danielsidhion:nixos.devdanielsidhion I wasn't aware of that. Looks like some tech debt saying hello 🥲
On the devmode server things look fine, which is what I think most folks use to check the result of their writing
14:21:07
@danielsidhion:nixos.devdanielsidhionI created a PR to fix it. Docs team meeting is soon, so I'll make sure we go over it https://github.com/NixOS/nixpkgs/pull/29234014:26:49

Show newer messages


Back to Room ListRoom Version: 6