Standartization of output marker for Example section about noogle HOT 2 CLOSED

Excellent idea... We need a standard for many things in the comments.
If you're interested, I opened an RFC for the doc-comments in general -> NixOS/rfcs#145.

I'm looking forward that laying the foundation for further enhancements and rich features within doc-comments.
But before we can specify rich features we need to specify what a doc-comment is.

Currently, I expect the comments to be refactored to be doc-comments. From there, I think of something like tesh to test the examples in nixpkgs, which would be nice.

Once the format of doc-comments is specified, we can move forward to identify more rich features, such as examples that can be tested and types that everyone can use. So if you feel capable of it, you could write an RFC for that (based on RFC145, of course)

Unfortunately, Noogle cannot just change how nixpkgs currently is. If you want my opinion there:
-> is already a valid nix-token TOKEN_IMPLICATION. It could feel natural to use it here, although it is not used like that in Nix.

Suppose you want to test examples in your nix-codebase right away. You can fork the noogle/indexer (which outputs JSON) and feed it into something like Tesh (mentioned above).

from noogle.

Not planned. Noogle (for now) focuses only on documentation discovery. ;)

from noogle.