In reply to @infinisil:matrix.org
I generally inspect the web elements to find them

And now we depend on a certain web-elements beeing present on the same page ^^.
I'll try to find a solution for this., because it hinders us moving to newer formats. Any suggestions?

idea:

Something like
see [lib.lists.foldl]

Without any further. The rendering framework can transform this into references for achor tags, if it uses them.
I tried using a different rendering framework that uses seperate pages and doesnt have those exact anchors.

In reply to @infinisil:matrix.org
I generally inspect the web elements to find them

And now we depend on a certain web-elements beeing present on the same page ^^.
I'll try to find a solution for this., because it hinders us moving to newer formats. Any suggestions?

idea:

Something like
see [lib.lists.foldl']

Without any further. The rendering framework can transform this into references for achor tags, if it uses them.
I tried using a different rendering framework that uses seperate pages and doesnt have those exact anchors.

That opens the box of pandora: context aware references ^^

{
   /**
   # Params

  - [a] A number
  - [b] Another number

   */
   lib.foo = a: b: a +b;
}

😃

That opens the box of pandora: context aware references ^^

{
   /**
   See also [lib.trivial.add]
   # Params

  - [a] A number
  - [b] Another number

   */
   lib.foo = a: b: a +b;
}

😃

Can't run nix.dev devmode:

❯ nix-shell --run devmode
error:
       … while calling the 'import' builtin

         at «string»:1:2:

            1| (import <nixpkgs> {}).bashInteractive
             |  ^

       … while calling the 'findFile' builtin

         at «string»:1:9:

            1| (import <nixpkgs> {}).bashInteractive
             |         ^

       error: file 'nixpkgs' was not found in the Nix search path (add it using $NIX_PATH or -I)

       at «none»:0: (source not available)
will use bash from your environment
Doing an initial build of the docs...

In reply to @johannes.kirschbauer:scs.ems.host
Whats in your $NIX_PATH, is it empty ?

In reply to @asymmetric:matrix.dapp.org.uk

Can't run nix.dev devmode:

❯ nix-shell --run devmode
error:
       … while calling the 'import' builtin

         at «string»:1:2:

            1| (import <nixpkgs> {}).bashInteractive
             |  ^

       … while calling the 'findFile' builtin

         at «string»:1:9:

            1| (import <nixpkgs> {}).bashInteractive
             |         ^

       error: file 'nixpkgs' was not found in the Nix search path (add it using $NIX_PATH or -I)

       at «none»:0: (source not available)
will use bash from your environment
Doing an initial build of the docs...

In reply to @johannes.kirschbauer:scs.ems.host

It might be personal thing... I don't like those achor tags in our nix code because strictly bind our lib documentation to the current manual rendering, with those exact achor tags. Changing something in rendering (e.g. splitting in multiple pages) now means also breaking the documentation.

See [`lib.lists.foldl'`](#function-library-lib.lists.foldl-prime) but for attribute sets.

Has this been discussed in the documentation team? I'd prefer to keep the actual content un-opinionated from our rendering framework, and place neutral references, that are autoresolved instead of hard links, which break when touching the thing.

We haven’t discussed this, but someone recently made me aware of https://github.com/stepchowfun/tagref

I think it’s a nice idea, and seems like it would scale better than the reference system Sphinx uses (which in its MyST incarnation can’t discern between file paths and references… it produces a lot of busywork).

In reply to @alejandrosame:matrix.org
I think my new PR fixes this completely. At least it does handle properly the syntax error you mention in your issue :)

In reply to @fricklerhandwerk:matrix.org
I’m not sure why there is a need for NIX_PATH to be set. Why and when did it even break? It worked a couple of days ago.

In reply to @fricklerhandwerk:matrix.org
I’m not sure why there is a need for NIX_PATH to be set. Why and when did it even break? It worked a couple of days ago.

In reply to @antifuchs:asf.computer
just noticed the entire lib.meta attrset of functions isn't documented in the nixpkgs manual yet... they have source code comments, but none of the functions can be found. I'd be happy to try and craft a PR for that, but am wondering if I'm missing some policy / better taxonomy or something?

In reply to @antifuchs:asf.computer
fricklerhandwerk: while I have your attention on the library TOC, do you think it (https://nixos.org/manual/nixpkgs/unstable/#sec-functions-library) should be sorted alphabetically? the order doesn't make much sense to me and that makes it difficult to find things that are missing

Sure, I wouldn’t know why not.

Side note: I’m not that involved in the Nixpkgs manual because the Nix manual and nix.dev are enough to deal with, so my knowledge and opinions are quite superficial. There are likely other people who will have more substantial things to say: infinisil Robert Hensing (roberth) @pennae alejandrosame come
to mind.