Nix Documentation | 415 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 89 Servers |
| Sender | Message | Time |
|---|---|---|
| 31 Aug 2022 | ||
| And maybe https://nixos.org/manual/nixpkgs/stable/#sec-patches. Even now it provides a questionable example. | 18:46:16 | |
In reply to @sandro:supersandro.dei 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 | ||
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 | |
| fricklerhandwerk: do you not have a write access to pills as a nixpkgs committer? | 08:07:59 | |
| I can merge the EPUB PR myself but would prefer a review first | 08:08:28 | |
| fricklerhandwerk: now we just need to merge https://github.com/NixOS/nixos-homepage/pull/776 | 09:27:56 | |
| its going into https://github.com/NixOS/nixpkgs/blob/master/doc/contributing/coding-conventions.chapter.md#fetching-sources-sec-sources | 09:59:32 | |
| https://github.com/NixOS/nixpkgs/pull/189241 | 10:12:46 | |
| is there any reason to ever use the short hash? | 15:55:17 | |
| in any git context? | 15:55:25 | |
| Redacted or Malformed Event | 16:02:59 | |
| 2 Sep 2022 | ||
| sometimes it is more convenient to type it manually than to copy it (e.g. when working on command line without mouse) | 08:58:58 | |
In reply to @tpw_rules:matrix.orgif you only need it for 5 minutes, it can be convenient but for anything log lived it shouldn't be used | 10:33:43 | |
| 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 in a comment you might not be able to look it up later | 12:44:52 | |
| * 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 | |
| * 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 | |
| well, git diffs have short hashes by default but they are not resolved for applying | 13:26:53 | |
| but it probably applies to most if not all other git hosting softwares | 13:27:57 | |
| 14:09:39 | ||
| 3 Sep 2022 | ||
| 17:37:37 | ||
| 8 Sep 2022 | ||
| https://nixos.wiki/wiki/Nix_Language_Quirks | 16:02:57 | |
| https://github.com/orgs/NixOS/teams/documentation-team/members | 16:23:27 | |
| abent 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 | |
In reply to @infinisil:matrix.orgstill rather fond of quirks like let __sub = __add; in 1 - 2 | 16:46:18 | |
| 9 Sep 2022 | ||
| 20:20:05 | ||
| 13 Sep 2022 | ||
| 06:58:30 | ||
| 14:11:00 | ||
| 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:
Let me know and if you like the direction I am happy to attempt an improvement :) | 14:12:59 | |
| * 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:
Let me know and if you like the direction I am happy to attempt an improvement :) | 14:13:10 | |
| 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 | |