!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

435 Members
Discussion about documentation improvements around the Nix ecosystem92 Servers

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


SenderMessageTime
5 Jul 2023
@wamirez:matrix.orgwamirezHello NixOS documentation team, this is Daniel and I wanted to introduce myself to you all as briefly as possible to not break the flow of your conversation. The reason for my showing up out of the blue is that I'd like to become more familiar with the Nix environment/community, with the goal of landing a spot in one of next year's Summer of Nix mobs as a participant. I've been catching up here and there with "new" paradigms and tools like functional programming, lambda calculus, and Haskell, after many years of procedural programming being beaten into my head by university courses and then of me doubling down on it on my own. I chose to study the closest thing to my hobby (mountaineering) that my home university had to offer, which at the time was geological engineering, only to find out later that a hobby is usually just that: a hobby. Nevertheless, I'd like to think that I have a good framework for tackling problems, and also good language skills that can be of use to contribute to documentation projects you may have or need help with :). On a superficial level, and to get me started, I thought I could process some of the Nix Hour recordings and come up with news articles based on them to make myself acquainted with the jargon and the ecosystem before working on Nix.dev's open issues and/or pull requests. Of course, I'm open to any suggestions or roadmaps you may already have in place. Cheers from the Venezuelan Andes, Daniel Ramírez23:41:36
@wamirez:matrix.orgwamirez set a profile picture.23:48:25
6 Jul 2023
@mightyiam:matrix.org@mightyiam:matrix.orgWelcome00:02:21
@fricklerhandwerk:matrix.orgfricklerhandwerk Hey Daniel, awesome to have you! I warmly recommend to say hi in the team meetings, and feel your way around nix.dev and our maintainers handbook. We have lots of stuff going on where help would be highly appreciated. 00:09:54
@wamirez:matrix.orgwamirez
In reply to @mightyiam:matrix.org
Welcome
Thank you Dawn!
00:39:29
@wamirez:matrix.orgwamirez
In reply to @fricklerhandwerk:matrix.org
Hey Daniel, awesome to have you! I warmly recommend to say hi in the team meetings, and feel your way around nix.dev and our maintainers handbook. We have lots of stuff going on where help would be highly appreciated.

Thanks a lot!

I will take a look at those and will definitely stop by to say hello in the team meetings.

00:44:53
@zmitchell:matrix.org@zmitchell:matrix.org Running a couple of minutes late for the meeting, be there in a second 13:01:27
@mightyiam:matrix.org@mightyiam:matrix.orgAs far as I know it's an hour from now.13:02:04
@i97henka:matrix.orghenrik-chThis is the learning journey working group13:02:24
@mightyiam:matrix.org@mightyiam:matrix.orgOh, okay13:02:42
@pennae:matrix.eno.spacepennae

couldn't make it to the meeting, but checking the notes:

is it OK to pull in nodejs and a larger tree of dependencies for an update to the manuals' build system? This is related to a live-reload feature.

no, we worked our ass of getting large dependencies out of the manual

15:19:37
@pennae:matrix.eno.spacepennae *

couldn't make it to the meeting, but checking the notes:

is it OK to pull in nodejs and a larger tree of dependencies for an update to the manuals' build system? This is related to a live-reload feature.

no, we worked our ass off getting large dependencies out of the manual

15:19:44
@pennae:matrix.eno.spacepennae live reload isn't something we can currently do at all anyway because every rebuild is necessarily a complete rebuild 15:21:30
@pennae:matrix.eno.spacepennae there's no benefit to adding that much complexity over a small script that's pretty much inotifywait | while read; do nix-build; done 15:22:09
@pennae:matrix.eno.spacepennae(we're in favor of the script fwiw)15:22:30
@pennae:matrix.eno.spacepennaewe really have to get other things in order first before live-reload even begins to make sense15:33:50
@ronef:matrix.orgronef

Quick update & question. We plan to announce the migration of Nix.dev to the community/foundation.

  1. Let me know if there's any thoughts on that
  2. I thought to take advantage of that announcement and potentially mention that folks can join the documentation team if they wish to contribute. Would this be relevant/interesting? If so, what's the best way for an interested community member to reach out?
15:44:05
@zmitchell:matrix.org@zmitchell:matrix.org
In reply to @ronef:matrix.org

Quick update & question. We plan to announce the migration of Nix.dev to the community/foundation.

  1. Let me know if there's any thoughts on that
  2. I thought to take advantage of that announcement and potentially mention that folks can join the documentation team if they wish to contribute. Would this be relevant/interesting? If so, what's the best way for an interested community member to reach out?
  1. I think it's good to make the announcement with the context that it's intended to be the home of Nix documentation, but there's lots of work to do in order to get it looking how we want.
  2. I think the best place would be to direct them to this page (https://github.com/NixOS/nix.dev/tree/master/maintainers) since it has links to our weekly meetings, how people can contribute, etc. We can always use more maintainers. The best way to get in touch is through our weekly meetings since it's more efficient to transmit context that way. If they can't make the meetings, which is totally understandable, I would say the Nix Documentation Matrix channel (this channel).
16:22:05
@ronef:matrix.orgronefSending the announcement for review, feel free to edit directly :) 16:55:17
@zmitchell:matrix.org@zmitchell:matrix.org I think we should add a linkchecker run triggered on a timer to nix.dev GitHub Actions. I pretty frequently get failed CI runs that have nothing to do with my changes because an anchor link somewhere broke. For instance: here 18:34:51
7 Jul 2023
@tnias:stratum0.orgtnias left the room.20:24:41
9 Jul 2023
@spacekookie:fairydust.spacekookie changed their display name from kookie to kookie (offline).14:31:49
10 Jul 2023
@boozedog:matrix.orgDavid A. Buser (boozedog) joined the room.15:47:52
11 Jul 2023
@quark97:matrix.org@quark97:matrix.org joined the room.03:39:32

Show newer messages


Back to Room ListRoom Version: 6