!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

418 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
21 Oct 2022
@adam:valkor.netadamcstephens joined the room.17:12:30
@yuki:backalley.clubYuki (they/them) joined the room.21:28:00
22 Oct 2022
@ruby:isincredibly.gayruby joined the room.04:52:26
@fricklerhandwerk:matrix.orgfricklerhandwerkPlanning what to do in the next 3 months: https://pad.lassul.us/gshjat31S9uSDX5GwhKeOw?edit08:14:49
@Minijackson:matrix.orgMinijackson joined the room.08:29:43
@john-rodewald:matrix.orgjohn-rodewald joined the room.10:05:22
@john-rodewald:matrix.orgjohn-rodewald set a profile picture.10:08:49
@FRidh:matrix.orgFRidhI think we should work to having testable examples. That is, CI test the code in tests. Of course our integration tests do that exactly for certain guides. But otherwise, I think we may learn here fromother ecosystems10:37:03
@FRidh:matrix.orgFRidhFor discoverability we can tag hooks. https://github.com/NixOS/nixpkgs/issues/197070 This way we can find them easier and include in docs or highlight them on the packages website10:40:27
@brainrape:ggpeti.combrainrake joined the room.11:11:21
@brainrape:ggpeti.combrainrake👋11:12:11
@ruby:isincredibly.gayrubyHi all - popping in to say I'd love to help lend a hand with contributing to Nix documentation! Was watching Valentin's talk on the NixCon livestream last night, and it's nice to see that we've got a strong effort growing to help address one of my biggest pain points with using Nix, as well as recommending it to my friends. More than happy to lend a hand whereever needed 😄11:44:03
@brainrape:ggpeti.combrainrakeWe're having a meeting about that right now ^12:02:45
@yuki:backalley.clubYuki (they/them)We're currently having a meeting at NixCon. You can lurk what we're thinking/talking about: https://pad.lassul.us/gshjat31S9uSDX5GwhKeOw?edit12:00:58
@brainrape:ggpeti.combrainrakeThis is a service that sends you random issues to review in configurable intervals https://www.codetriage.com/12:03:14
@yuki:backalley.clubYuki (they/them)
In reply to @yuki:backalley.club
We're currently having a meeting at NixCon. You can lurk what we're thinking/talking about: https://pad.lassul.us/gshjat31S9uSDX5GwhKeOw?edit
Essentially, we're discussing on bootstrapping the documentation contribution pipeline
12:01:53
@ruby:isincredibly.gayruby
In reply to @brainrape:ggpeti.com
This is a service that sends you random issues to review in configurable intervals
https://www.codetriage.com/
oh this is cool! might give it a go
12:08:20
@pkharvey:defenestrate.itpkharvey joined the room.14:31:39
@alejandrosame:matrix.orgalejandrosame joined the room.15:29:22
@drtobbe:matrix.orgTobbe joined the room.16:56:17
@waldyrious:matrix.orgwaldyrious
In reply to @waldyrious:matrix.org
Oh, it looks like a room can belong to both a space and one of its subspaces (e.g. the NixOS on ARM room does this). Could the same be done for this room?
grahamc (he/him) / Domen Kožar — do you think this could be done for this room? I.e. make it be included in both the "teams" subspace and the top-level NixOS space?
20:03:22
@yuki:backalley.clubYuki (they/them)I wonder whether the documentation for everything related to contributing documentation should have a dedicated section in nix.dev21:45:08
@yuki:backalley.clubYuki (they/them)Meh, I’ll just do it next week and make a PR so y’all can see instead of wasting time explaining it here.21:47:08
24 Oct 2022
@alex:tunstall.xyzAlex joined the room.21:10:38
@alex:tunstall.xyzAlexThe "Nix language basics" link under the "Next steps" section of https://nixos.org/guides/ad-hoc-developer-environments.html is broken. It seems like it was meant to link to https://nix.dev/tutorials/nix-language#reading-nix-language, but that page hasn't been put on nixos.org.21:12:47
25 Oct 2022
@denna:matrix.orgolaf
In reply to @alex:tunstall.xyz
The "Nix language basics" link under the "Next steps" section of https://nixos.org/guides/ad-hoc-developer-environments.html is broken.
It seems like it was meant to link to https://nix.dev/tutorials/nix-language#reading-nix-language, but that page hasn't been put on nixos.org.
the issue should be in this script: https://github.com/NixOS/nixos-homepage/blob/master/scripts/copy-nix-dev-tutorials.sh either open a issue in the repository (or create a pr if you have the time).
06:37:11
@nikstur:matrix.orgnikstur joined the room.21:53:10
26 Oct 2022
@fsbof:matrix.orgfsbof joined the room.00:10:35
@fricklerhandwerk:matrix.orgfricklerhandwerk Alex: made a pull request to fix that: https://github.com/NixOS/nixos-homepage/pull/929 09:42:18
@b:chreekat.netchreekatSome feedback from having someone ask me about flakes: after viewing https://nixos.wiki/wiki/Flakes ("clear as mud") and after I linked them to https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-flake.html#description, they still say "It still doesn't say what they actually do... or why they are called flakes"10:42:15

There are no newer messages yet.


Back to Room ListRoom Version: 6