Thread has gotten pretty long so dont know if this was already mentioned. There are few module docs in Nixpkgs targeting specific modules, often written by maintainers themselves because docstrings aren’t enough.
Can we possibly auto-genrate wiki pages for them and linking back to nixpkgs? So source of truth remains at the source code, but still benefits from SEO and discoverability of wiki.
Unsure on how much effort would be for translation. Might want to limit to unstable/stable branches to reduce page churn. Also want to limit write access to auto generated pages to not lose user changes to wiki on next page gen.
Just something to think about. I don’t know anything about mediawiki, but will happily work on it if people think its a good idea.
(EDIT: sorry, I misread your message and thought you were a maintainer of the old wiki) I definitely don’t want to take any hostile actions against the old wiki (that I both used and tried to improve)… but I still don’t understand why it would be bad to suggest users to check the new wiki with a link like @MikulasVanousek added (maybe with a lack of coordination, possibly explaining why someone removed the links), as it leaves the original content unchanged. The current status (official vs yours that is better referenced by search engines) will inevitably lead to a useless fork of the documentation, which will result in users reading outdated documentation. I guess you can agree, Nix does not need something like that. So, to maintain an healthy spirit, could you please consider adding a link suggesting users to additionally read the official Wiki?
Oh, my bad, I read @JulienMalka 's message to quickly, I thought he was a maintainer of the old wiki, and I thought he reverted the changes of @MikulasVanousek. In my opinion, @MikulasVanousek’s code was the best strategy to solve this issue (and it does not harm the old wiki’s content at all)… but seems like someone reverted this changed, no idea who then…
That’s really sad and, IMHO, quite selfish. Not sure what to do then, except from regularly adding this warning manually, and trying to get the official wiki better referenced.
On a different topic, I see the wiki as a great opportunity to translate the documentation (for now, NixOs’s documentation is very english-orientated). But so far I can’t see a way to add a translation on Wiki’s page. Could the maintainer enable this option?
Just thought I should mention this userscript that redirects you to the new wiki when accessing the old wiki. It’s linked to by the official wiki’s FAQ if anyone’s interested.