!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

399 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

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


SenderMessageTime
4 Nov 2024
@Minijackson:matrix.orgMinijacksonthis page then: https://nix.dev/tutorials/module-system/a-basic-module/ ?13:56:39
@Minijackson:matrix.orgMinijacksonor the deep dive?13:56:42
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @Minijackson:matrix.org
Note that right now, the project is only useful for project that define their own NixOS option. I'd like to make a Sphinx role for referring to options defined in nixpkgs, but it's not implemented right now
If it works via optionsDoc and one can pass a config it should be easy to just hand it anything, including NixOS stuff, right?
13:56:51
@Minijackson:matrix.orgMinijackson
In reply to @fricklerhandwerk:matrix.org
If it works via optionsDoc and one can pass a config it should be easy to just hand it anything, including NixOS stuff, right?
yup
13:57:14
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @Minijackson:matrix.org
this page then: https://nix.dev/tutorials/module-system/a-basic-module/ ?
Yeah that would work. Anything you like and is a quick win
13:57:17
5 Nov 2024
@asymmetric:matrix.dapp.org.ukasymmetric hey, just noticed that some of the links in this page are actually anchors to this article, i.e. they shouldn't be there 11:48:49
@asymmetric:matrix.dapp.org.ukasymmetric * hey, just noticed that some of the links on this page are actually anchors to this article, i.e. they shouldn't be there 11:49:05
@asymmetric:matrix.dapp.org.ukasymmetrice.g. "Prerequisites"11:49:26
6 Nov 2024
@getpsyched:matrix.orggetpsyched Hi, @Soenke Klinger. Is it cool if we continue our release notes conversation here? The 24.11 release is almost here and if we want have additions, now would be a good time :) 09:21:59
@soenke:hack-hro.desoenke @getpsyched:matrix.org: thought about contacting,you. Its good, meybe we need,two discussions. Here about the Documentation ecosytem and manuals. And in the wiki channel about the wiki content? 13:09:38
@getpsyched:matrix.orggetpsychedAbsolutely.13:11:46
@getpsyched:matrix.orggetpsychedI'll get getchoo to join, so we can get things moving quickly13:13:53
@seapat:matrix.orgseapat joined the room.13:50:48
@pyrox:pyrox.devdish [Fox/It/She]whoa getchoo reference 🤯15:21:16
@soenkeklinger:matrix.orgSoenke Klinger fricklerhandwerk: Could you coordinate the discussion about documentation release notes here with getpsyched? 18:44:49
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @soenkeklinger:matrix.org
fricklerhandwerk: Could you coordinate the discussion about documentation release notes here with getpsyched?
Sure, what exactly is it about?
18:45:46
@soenkeklinger:matrix.orgSoenke KlingerNixOS 24.11 release notes. Its a good idea to describe what happened regarding documentation. (In wiki channel, we write about the wiki part). Release notes are a good place include some relevant information about the ecosystem and not only about package-version-upgrades..18:48:32
@getpsyched:matrix.orggetpsyched Let's get on the same page about a few non-variables (mostly reiterating from the conversation we had),
  1. These release notes will be in the highlights section

  2. 2-3 sentences per release note (and how many of those?)

Same goes for the other documentation (non-wiki) release notes
18:53:31
@getpsyched:matrix.orggetpsychedAs discussed, we won't keep a criteria for the content itself, and that can be decided internally by both teams18:54:21
@getpsyched:matrix.orggetpsyched Let's get on the same page about a few non-variables (mostly reiterating from the conversation we had),
  1. These release notes will be in the highlights section

  2. 2-3 sentences per release note (and how many of those?)

Same goes for the wiki's release notes
18:56:54
@getchoo:matrix.orggetchoo joined the room.21:26:55
@getchoo:matrix.orggetchoo
In reply to @pyrox:pyrox.dev
whoa getchoo reference 🤯
😄
21:27:16
@pyrox:pyrox.devdish [Fox/It/She]
In reply to @getchoo:matrix.org
😄
👁️
21:40:36
13 Nov 2024
@inayet:matrix.orginayet joined the room.22:16:45
19 Nov 2024
@federicodschonborn:matrix.orgWormy McWormface 🏳️‍🌈 (he/they) changed their display name from Federico Damián Schonborn to LEGO® Worm™.01:06:27
20 Nov 2024
@inayet:matrix.orginayet removed their profile picture.00:59:35
@adam:robins.wtf@adam:robins.wtf joined the room.16:53:28

Show newer messages


Back to Room ListRoom Version: 6