!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

436 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
12 Oct 2023
@asymmetric:matrix.dapp.org.ukasymmetric Yep, I think I know of them thanks to your post which gathers them all. I was more asking if there’s any concerted effort to get this all merged. If not I’d like to take this on, and could of course use some help from people who have put effort in it so far 09:10:31
@asymmetric:matrix.dapp.org.ukasymmetric* Yep, I think I know of them thanks to your post which gathers them all. I was more asking if there’s any concerted effort to get this all organized, improved and merged. If not I’d like to take this on, and could of course use some help from people who have put effort in it so far09:41:31
@alejandrosame:matrix.orgalejandrosameRedacted or Malformed Event10:34:26
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostI want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs.10:47:14
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. (This is still a POC) 10:48:47
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. (This is still a POC so expect bugs and beeing incomplete) 10:55:05
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk
Yep, I think I know of them thanks to your post which gathers them all. I was more asking if there’s any concerted effort to get this all organized, improved and merged. If not I’d like to take this on, and could of course use some help from people who have put effort in it so far
No one currently working on it actively. Would be awesome if you could take that on.
12:44:28
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. (This is still a POC so expect bugs and beeing incomplete)
This looks great. Still, as @roberth suggested elsewhere recently, we should not encourage using builtins to keep separation of concerns. I suggest rendering what you have to the Nixpkgs manual. It would also avoid getting into hairy consistency problems between Nix and Nixpkgs documentation. The nix.dev reference section should ideally consist only of links to the manuals, but some things are currently hard to do in an ideal way.
12:51:08
@roberthensing:matrix.orgRobert Hensing (roberth)
In reply to @fricklerhandwerk:matrix.org
There are 1-2 open PRs to the Nixpkgs manual by Robert Hensing (roberth)
I can do a round of review processing. Yoloing my schedule a bit
12:52:51
@roberthensing:matrix.orgRobert Hensing (roberth)as in right now12:53:21
@alejandrosame:matrix.orgalejandrosameI won't be able to join today. Let me know if I need to something else regarding PR 51513:10:24
@fricklerhandwerk:matrix.orgfricklerhandwerkMe neither, sorry for the short notice13:28:25
@alejandrosame:matrix.orgalejandrosame* I won't be able to join today. Let me know if I need to do something else regarding PR 51513:52:45
@davidak:matrix.orgdavidakFYI: MEME about NixOS docs 😬 https://mstdn.social/@runarcn/11121589287393387716:46:09
@adam:robins.wtf@adam:robins.wtfoof18:18:34
13 Oct 2023
@lorenzleutgeb:matrix.orgLorenz Leutgeb

FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format :[<n>:]<path>.

See:

  • [Git Glossary](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftree-ishatree-ishalsotreeish
  • Git Revisions
14:49:15
@lorenzleutgeb:matrix.orgLorenz Leutgeb *

FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format :[<n>:]<path>.

See:

  • [Git Glossary](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftree-ishatree-ishalsotreeish)
  • Git Revisions
14:49:21
@lorenzleutgeb:matrix.orgLorenz Leutgeb *

FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format :[<n>:]<path>.

See:

14:49:30
@lorenzleutgeb:matrix.orgLorenz Leutgeb *

FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format <rev>:[<n>:]<path>.

See:

19:24:16
14 Oct 2023
@b:chreekat.netchreekat changed their display name from chreekat (afk, sick) to chreekat.08:54:15
@asymmetric:matrix.dapp.org.ukasymmetric

i've been mentioned directly here, not sure why, but anyway: as the docs team, do we have anything to say in this regard? Or can I go ahead and say "No blockers from the doc team"?

I think it's a no-brainer but wanted to check with someone else first

12:46:54
@asymmetric:matrix.dapp.org.ukasymmetricoh i see why: https://github.com/NixOS/nixpkgs/tree/1af277b55ed1fd600bc917233c83c51d06e14b8f/maintainers/team-list.nix#L25212:50:06
@asymmetric:matrix.dapp.org.ukasymmetric

two questions:

  1. can/should we sync this with the members on github?
  2. why are we enableFeatureFreezePing = true?
12:51:16
@asymmetric:matrix.dapp.org.ukasymmetric ok 2. makes sense after reading this, although it seems to me it should default to true 13:26:04
15 Oct 2023
@nonuke:matrix.orgnonukeHi all, here I am back asking for help. :) 07:41:06
@nonuke:matrix.orgnonukeI've managed to build my software, and if I want I can run it directly from result/bin directory. 07:41:43
@nonuke:matrix.orgnonukeI've added a installPhase: installPhase = '' mkdir -p $out/bin cp $out/comictagger $/out/bin ''; 07:42:38
@nonuke:matrix.orgnonukeIt gives me an error:07:42:51
@nonuke:matrix.orgnonukecp: cannot stat '/nix/store/mk60dlmvk66lwylm6kcs6r0kpzf9ikgd-comictagger/comictagger': No such file or directory07:43:19
@nonuke:matrix.orgnonukeas a matter of fact, when I ls the path, there is no executable there... What am I missing?07:44:29

Show newer messages


Back to Room ListRoom Version: 6