In reply to @infinisil:matrix.org
djacu: Unfortunately that's as expected, I think it uses nix-build underneath 😅

In reply to @fricklerhandwerk:matrix.org
Yes, and unfortunately that's still better than Sphinx randomly not updating stuff that changes. I was so fed up with it that I took the performance hit

laughs/cries in mkDocs

But seriously, if we want to have a discussion about mkDocs, I have had experience with it. I can't remember who, but I spoke with someone on the docs team about it like a month ago.

In reply to @fricklerhandwerk:matrix.org
Yes, and unfortunately that's still better than Sphinx randomly not updating stuff that changes. I was so fed up with it that I took the performance hit

laughs/cries in mkDocs

But seriously, if we want to have a discussion about mkDocs, I have had experience with it. I can't remember who, but I spoke with someone on the docs team about it like a month ago (and it was mentioned during the meeting today).

In reply to @djacu:matrix.org

laughs/cries in mkDocs

But seriously, if we want to have a discussion about mkDocs, I have had experience with it. I can't remember who, but I spoke with someone on the docs team about it like a month ago (and it was mentioned during the meeting today).

In reply to @johannes.kirschbauer:scs.ems.host
danielsidhion: Was carrying together more documentation frameworks pros and cons. Ideally we'd find some architectural solution/improvement for the nix-ecosystem as a whole. But thats another long story.

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

https://ethercalc.net/dc4vcnnl8zv0

In reply to @johannes.kirschbauer:scs.ems.host
Hm. Not sure this belongs to danielSidhion. I'd at least not delete stuff, but if you know some answers that you'd save a lot of time i guess.

In reply to @johannes.kirschbauer:scs.ems.host
Hm. Not sure this belongs to danielSidhion. I'd at least not delete stuff, but if you know some answers that you'd save a lot of time i guess.

Hey team

I met null in the JB Nix Nerds matrix space. We've been chatting about how they can get involved and they mentioned they are a Technical Writer. They said they would like to help out so I invited them here and gave them a link to the nixos calendar.

In reply to @deltaflow:matrix.org
Hi all, love Nix, love the community, and looking to help out wherever I can. I'm in technical writing/editing/knowledge management for a telecommunications company by trade, so hoping I can use those skills here.

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.