In reply to @johannes.kirschbauer:scs.ems.host
djacu: no the RFC is not strict in those terms. danielsidhion and me worked on what is more like conventions. There are other files in lib that use commonmark already in comments for reference

Ah okay. I saw things like this and wasn't sure.

# Inputs

    `f`
    : 1\. Function argument

I do like it though!

Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.

Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation

I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least

1. Sort it; now it's hard to find anything in it
2. I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.

Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, flake, home manager.

Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)

Hey. I'm a new NixOS user, already trying to heavily use the documentation. :) Someone pointed out to me that there's two wikis, with a difference. I've been looking at the NixOS manual, but had missed at least this.

Now I'm looking for glossaries. Is this the best we have? https://nix.dev/manual/nix/2.23/glossary.html#gloss-store-derivation

I could perhaps contribute (as in I can make a PR) by... Hm. My initial idea would be to at least

1. Sort it; now it's hard to find anything in it
2. I actually think that page could use a TOC. Or some kind of a layout change, I'm not sure. Now if I want to find something on it, my best bet is to do a search in browser, and that hits other mentions of the word.

Also I feel it's missing quite a few pieces of terminology that I've run into a lot the past few days. I think at least module, option, store, package, generation, flake, home manager.

Then I don't know what of those are Nix and what are NixOS. Is there a hard split between "Nix documentation" and "NixOS documentation"? (Though if we expect a newcomer to know which manual to look in, maybe that's a problem in itself?)