!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

351 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com Documentation office hours are open for anyone interested in solving problems, getting contributions reviewed in real time, or becoming a maintainer. Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 80 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
28 Jun 2024
@purepani:matrix.orgpurepani
In reply to @johannes.kirschbauer:scs.ems.host

xD friday semver checks with infinisil list comprehension method ^^ (Please do not use this)

nix-repl> [ 1.0.0 ] > [ 0.9.9 prerelease:build ]
true

nix-repl> [ 1.0.0 ] > [ 1.0.0 prerelease:build ] 
false

nix-repl> [ 1.0.0 release:build ] > [ 1.0.0 prerelease:build ]
true

nix-repl> [ 3.1.4 rc:1.0+20230401.build1234 ] < [ 3.1.4 rc:1.1+20230401.build1234 ]  
true

nix-repl> [ 3.1.4 rc:1.0+20230401.build1234 ] > [ 3.1.4 rc:1.1+20230401.build1234 ] 
false

https://jubianchi.github.io/semver-check/#/^1.0.0-release%2Bbuild/1.0.0-prerelrease%2Bbuild

Would be fun if that worked for semver in general

what on earth ahaha
17:39:34
29 Jun 2024
@mib:kanp.aimib 🥐 joined the room.22:24:29
2 Jul 2024
@zyansheep:matrix.orgZyansheep joined the room.04:36:20
@fastloris:tchncs.de@fastloris:tchncs.de joined the room.11:06:45
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @fricklerhandwerk:matrix.org
Thanks Stefan Schroeder Johannes Kirschbauer @hsjobeki, I'll take that into account when I get to recording the next thing

Here's another video: https://youtu.be/82UxXZv6Vhk

I haven't recorded a new one yet, but I'll incorporate any feedback for the next thing I do

13:41:13
@janik0:matrix.org@janik0:matrix.org left the room.13:44:11
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki fricklerhandwerk: great video.
🚀
I find it always impressing how you find and fix these little odd things.
15:31:01
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki

Who got commit rights and would like to review a 2k lines changed pr? 😬

https://github.com/NixOS/nixpkgs/pull/323843/files

15:36:41
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiShould i split it?15:38:11
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki * Who got commit rights and/or would like to review a 2k lines changed pr? 😬
https://github.com/NixOS/nixpkgs/pull/323843/files
16:05:39
@djacu:matrix.orgdjacuI don't have commit rights but taking a look. I'm seeing some things that I can't find in RFC 145. Was the format updated in a another RFC?16:12:00
@fricklerhandwerk:matrix.orgfricklerhandwerkI can take a look this week, and merge some little fixups on the way16:15:49
@fricklerhandwerk:matrix.orgfricklerhandwerkOverall it's not that bad, looks pretty mechanical16:16:02
@fricklerhandwerk:matrix.orgfricklerhandwerk * Overall it's not that bad in terms of size, looks pretty mechanical. 16:16:12
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki djacu: no the RFC is not strict in those terms. danielsidhion and me worked on what is more like conventions. There are other files in lib that use commonmark already in comments for reference 16:29:54
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki
In reply to @fricklerhandwerk:matrix.org
Overall it's not that bad in terms of size, looks pretty mechanical.
Yeah just spent some hours sundays to go through all of those little things
16:31:17
@djacu:matrix.orgdjacu
In reply to @johannes.kirschbauer:scs.ems.host
djacu: no the RFC is not strict in those terms. danielsidhion and me worked on what is more like conventions. There are other files in lib that use commonmark already in comments for reference

Ah okay. I saw things like this and wasn't sure.

# Inputs

    `f`
    : 1\. Function argument

I do like it though!

17:28:37
4 Jul 2024
@philiptaron:matrix.orgPhilip Taron (UTC-8) left the room.15:46:27
@philiptaron:matrix.orgPhilip Taron (UTC-8) joined the room.15:56:12
@soispha:vhack.euBenedikt changed their display name from Soispha to Benedikt.19:10:58
5 Jul 2024
@devurandom:matrix.orgDennis joined the room.20:18:47
@sliedes:hacklab.fiSami Liedes joined the room.23:03:10
@sliedes:hacklab.fiSami Liedes

Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.

Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation

I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least

  1. Sort it; now it's hard to find anything in it
  2. I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.

Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, flake, home manager.

Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)

23:11:29
@sliedes:hacklab.fiSami Liedes *

Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.

Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation

I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least

  1. Sort it; now it's hard to find anything in it
  2. I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.

Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, generation, flake, home manager.

Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)

23:14:56

Show newer messages


Back to Room ListRoom Version: 6