Better, searchable interface for docs/wiki? (mkdocs, mdbook or similar)

[mfxa]

Hello,

Would it make sense to switch from the wiki to something like mkdocs, mdbook or similar, where the documentation is in markdown files, presented with a better interface for the purpose and, perhaps most importantly, be easily searchable?

I think this could also present the various example configuration/themes/screenshots in a better way.

It can still be pushed to/hosted on GitHub pages if wanted.

As an example niri recently moved from just using a github wiki to this:
https://yalter.github.io/niri/

Here's the related discussion:
YaLTeR/niri#1830

[mfxa]

I did my own conversion as a test: