!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

420 Members
Discussion about documentation improvements around the Nix ecosystem87 Servers

Load older messages


SenderMessageTime
19 Feb 2024
@soenkeklinger:matrix.orgSoenke Klinger changed their display name from soenkeklinger to Soenke Klinger.18:19:05
20 Feb 2024
@ubalot:matrix.orgubalot joined the room.10:09:07
@mightyiam:matrix.org@mightyiam:matrix.orgUpdate: the documentation tester has been released this Thaigersprint day. https://github.com/mobusoperandi/eelco I'm currently working on using it within nix.dev12:05:33
@szlend:matrix.orgszlend joined the room.18:58:53
@szlend:matrix.orgszlend changed their display name from siyo to szlend.19:00:39
21 Feb 2024
@fractivore:cyberia.club@fractivore:cyberia.club
In reply to @mightyiam:matrix.org
Update: the documentation tester has been released this Thaigersprint day.
https://github.com/mobusoperandi/eelco

I'm currently working on using it within nix.dev
that is dope, wow!
06:46:21
@mightyiam:matrix.org@mightyiam:matrix.org Lovely to read, symys . Truly. 13:48:31
@infinisil:matrix.orginfinisil Unfortunately I won't be there in tomorrows doc team meeting. It would be great if others could join and take meeting notes if something is being discussed. Cc danielsidhion henrik-ch 20:13:29
@dmills27:matrix.orgDominic MillsI've created a CFP for Google Season of Docs on discourse: https://discourse.nixos.org/t/call-for-google-season-of-docs-proposals-to-enhance-nix-documentation/4010721:42:10
@dmills27:matrix.orgDominic MillsFeel free to submit a proposal or add any comments if anything is unclear.21:42:33
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @infinisil:matrix.org
Unfortunately I won't be there in tomorrows doc team meeting. It would be great if others could join and take meeting notes if something is being discussed. Cc danielsidhion henrik-ch
I’ll be there
22:15:12
22 Feb 2024
@mightyiam:matrix.org@mightyiam:matrix.orgProgress: https://github.com/NixOS/nix.dev/pull/672#issuecomment-195861661904:05:24
@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

Show newer messages


Back to Room ListRoom Version: 6