In reply to @djacu:matrix.org
I can answer some of those questions when I have time. Is it okay to edit that document?

In reply to @jtojnar:matrix.org
The “I installed a library but my compiler is not finding it. Why?” section disappeared between these two revisions but it is not listed in the diff.

In reply to @danielsidhion:nixos.dev
I'm just catching up on (a lot of) discussions, feel free to!

So I created a new column for mkdocs with the Material theme. I've used it in the past and significantly improves the UX of mkdocs. I've answered most of the questions for that combo and I'll try to answer the questions for mkdocs by itself.

I don't understand some of the questions being asked. Could you elaborate on the following?

• Can we deep-link anywhere in the text? (Do you mean literally anywhere or just headers?)
• Does it support tagref or anything similar? (Can you give an example?)
• Does it support the example notation we currently use? (Can you give an example?)
• Can we get a list of all possible links that someone may use?
• How can we generate option docs with it? (I was under the impression that option docs can output to json or markdown. And you would want to create a webpage from that?)
• Can we render it to multiple pages?
• Can we fit the nixos module documentation in it?

In reply to @antifuchs:asf.computer
Think this is a diff display bug - selecting “visual” instead of “wikitext” shows the removal.