!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

387 Members
Discussion about documentation improvements around the Nix ecosystem85 Servers

Load older messages


SenderMessageTime
4 Nov 2024
@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.orgThe Worm 🏳️‍🌈 (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
@adam:robins.wtf@adam:robins.wtfHi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText16:55:26
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @adam:robins.wtf
Hi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText
I’m not even sure why examples are collapsed to begin with. Hard to find anything that way. I’d be in favor of changing it
16:57:35
@adam:robins.wtf@adam:robins.wtfIf anything I'd rather the equivalent be collapsed and the example visible by default :)16:58:05
@fricklerhandwerk:matrix.orgfricklerhandwerkI’ll gladly merge PRs!17:14:13
@adam:robins.wtf@adam:robins.wtfwhen i find some time i'll try and figure out how to do so, unless someone can point me in the right direction :)18:00:53
@fricklerhandwerk:matrix.orgfricklerhandwerk I’d take a look at the website’s HTML and then search for css files in doc to see where it’s styled.
If examples are in I’d also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs)
18:07:45
@fricklerhandwerk:matrix.orgfricklerhandwerk * I’d take a look at the website’s HTML and then search for css files in doc to see where it’s styled.
If examples are in<details> I’d also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs) 18:08:10

Show newer messages


Back to Room ListRoom Version: 6