!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

431 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
13 Feb 2024
@jade_:matrix.org@jade_:matrix.organd how to recognize them21:15:26
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @jade_:matrix.org
we should have a glossary of common top level Nix expression shapes

Opened an issue so we don’t forget

https://github.com/NixOS/nix.dev/issues/918

21:29:34
14 Feb 2024
@fractivore:cyberia.clubSYMYƧ
In reply to @adam:robins.wtf
hallucinations aren't great, but humans can provide incorrect information too, and it seems the alternative is going to chat/forum and asking humans to help. granted, that would be in a public forum where other people could correct the bad information
I guess generating docs could work if they get a PR and are reviewed just like human additions. It could be set to do it kinda slowly, like a doc a day, to reduce alert fatigue on that.
15:52:29
15 Feb 2024
@pkharvey:defenestrate.itpkharvey 08:13:00
@jtojnar:matrix.orgJan TojnarCould anyone please check https://github.com/NixOS/nix-pills/pull/228#issuecomment-194559074309:05:22
@jtojnar:matrix.orgJan TojnarI guess I have reviewed it too authoritatively and they closed it. 09:06:03
@infinisil:matrix.orginfinisilI'll be in the docs team meeting in a couple minutes15:00:53
@infinisil:matrix.orginfinisil(still a couple more)15:06:05
@i97henka:matrix.orgi97henka Sorry couldn't make it today - will join again soon I hope. 15:28:45
@infinisil:matrix.orginfinisil No worries :) 17:22:22
19 Feb 2024
@soenkeklinger:matrix.orgSoenke Klinger joined the room.18:18:11
@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.clubSYMYƧ
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

Show newer messages


Back to Room ListRoom Version: 6