!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

415 Members
Discussion about documentation improvements around the Nix ecosystem89 Servers

Load older messages


SenderMessageTime
31 Aug 2022
@trofi:matrix.orgtrofiAnd maybe https://nixos.org/manual/nixpkgs/stable/#sec-patches. Even now it provides a questionable example.18:46:16
@denna:matrix.orgolaf
In reply to @sandro:supersandro.de
Someone can give me a pointer where this https://github.com/NixOS/nixpkgs/pull/187797#discussion_r956789756 would fit into the doc?
i havn't read into the discussion but also have a look at fricklerhandwerk 's vision that has some good ideas what to put not into the manuals but into the book/nix.dev https://github.com/NixOS/nix.dev/blob/1bdb9be8012c2f44ce44c23fd6046ddb87e3772f/CONTRIBUTING.md#vision
20:51:26
1 Sep 2022
@fricklerhandwerk:matrix.orgfricklerhandwerk Sandro 🐧: I agree with Jan Tojnar (contributing guide, note and motivation/explanation) and trofi (the patch stuff, note and link to contributing guide) and the PR author (fetchFromGitHub, note and link to contributing guide) 06:54:44
@jtojnar:matrix.orgJan Tojnar fricklerhandwerk: do you not have a write access to pills as a nixpkgs committer? 08:07:59
@jtojnar:matrix.orgJan TojnarI can merge the EPUB PR myself but would prefer a review first08:08:28
@jtojnar:matrix.orgJan Tojnar fricklerhandwerk: now we just need to merge https://github.com/NixOS/nixos-homepage/pull/776 09:27:56
@sandro:supersandro.deSandro 🐧its going into https://github.com/NixOS/nixpkgs/blob/master/doc/contributing/coding-conventions.chapter.md#fetching-sources-sec-sources09:59:32
@sandro:supersandro.deSandro 🐧https://github.com/NixOS/nixpkgs/pull/18924110:12:46
@tpw_rules:matrix.orgtpw_rulesis there any reason to ever use the short hash?15:55:17
@tpw_rules:matrix.orgtpw_rulesin any git context?15:55:25
@raphi:tapesoftware.netraphiRedacted or Malformed Event16:02:59
2 Sep 2022
@jtojnar:matrix.orgJan Tojnarsometimes it is more convenient to type it manually than to copy it (e.g. when working on command line without mouse)08:58:58
@sandro:supersandro.deSandro 🐧
In reply to @tpw_rules:matrix.org
is there any reason to ever use the short hash?
if you only need it for 5 minutes, it can be convenient but for anything log lived it shouldn't be used
10:33:43
@tpw_rules:matrix.orgtpw_ruleslet me restate: is there any reason to record the short hash in a file in nixpkgs in any git context? i feel like the documentation calling out github specifically is short-sighted. presumably other git services do similar weird things. even in a comment you might not be able to look it up later12:44:52
@tpw_rules:matrix.orgtpw_rules * let me restate: is there any reason to record the short hash in a file in nixpkgs in any git context? i feel like the documentation calling out github specifically is short-sighted. presumably other git services do similar weird things. even if you say in a comment "since commit abcdef we X" that might become ambiguous later 12:45:29
@tpw_rules:matrix.orgtpw_rules * let me restate: is there any reason to record the short hash in a file contributed to nixpkgs in any git context? i feel like the documentation calling out github specifically is short-sighted. presumably other git services do similar weird things. even if you say in a comment "since commit abcdef we X" that might become ambiguous later 12:46:10
@sandro:supersandro.deSandro 🐧well, git diffs have short hashes by default but they are not resolved for applying 13:26:53
@sandro:supersandro.deSandro 🐧but it probably applies to most if not all other git hosting softwares13:27:57
@kity:kity.wtfproblems changed their display name from ash (it/its) 🏳️‍⚧️ to problems.14:09:39
3 Sep 2022
@alunduil:matrix.orgalunduil joined the room.17:37:37
8 Sep 2022
@infinisil:matrix.orginfinisilhttps://nixos.wiki/wiki/Nix_Language_Quirks16:02:57
@infinisil:matrix.orginfinisilhttps://github.com/orgs/NixOS/teams/documentation-team/members16:23:27
@pennae:matrix.eno.spacepennaeabent any other required changes we'd like to merge https://github.com/NixOS/nixpkgs/pull/189318 in a week. (will add a comment on the pr too.)16:29:32
@pennae:matrix.eno.spacepennae
In reply to @infinisil:matrix.org
https://nixos.wiki/wiki/Nix_Language_Quirks
still rather fond of quirks like let __sub = __add; in 1 - 2
16:46:18
9 Sep 2022
@cozypenguin:matrix.orgCarl Schierig joined the room.20:20:05
13 Sep 2022
@raphi:tapesoftware.netraphi changed their profile picture.06:58:30
@gianarb:matrix.orgGianluca Arbezzano joined the room.14:11:00
@gianarb:matrix.orgGianluca Arbezzano

I wrote this article on my blog after a few days of strugling learning a few new things (I am not that good with Nix yet). I am wondering if we can get something out of it for the netbooting wiki. For example:

  • Do we want to change it to use flake?
  • Should we add the nixos-rebuild vm-build to it?

Let me know and if you like the direction I am happy to attempt an improvement :)

14:12:59
@gianarb:matrix.orgGianluca Arbezzano *

I wrote this article (https://gianarb.it/blog/my-workflow-with-nixos) on my blog after a few days of strugling learning a few new things (I am not that good with Nix yet). I am wondering if we can get something out of it for the netbooting wiki. For example:

  • Do we want to change it to use flake?
  • Should we add the nixos-rebuild vm-build to it?

Let me know and if you like the direction I am happy to attempt an improvement :)

14:13:10
@fricklerhandwerk:matrix.orgfricklerhandwerk

Gianluca Arbezzano: Just took a look at https://nixos.wiki/wiki/Netboot - a great few first steps would be to split out the parts into separate files and add some explanation in between.

Your article appears to be a mostly guide with some story elements: it does not instruct the reader to build up the result step by step to help acquire the skill of making things like a tutorial would. Instead it just presents the absolutely necessary steps, assuming the reader will know what they are about. Also there are some personal things about how you got there.

Due to the large example it's not clear exactly which steps are required to do the job, and which are accidental to the example.The Wiki article could also use some context as introduction, such as linking to or explaining what netbooting is (for).

21:08:47

There are no newer messages yet.


Back to Room ListRoom Version: 6