openSUSE-docs-revamped-temp VS mkdocs-material

Looks like my source has been updated since I installed tumbleweed.

Unavoidable plug: - https://opensuse.github.io/openSUSE-docs-revamped-temp/best_of_post/ you can also check the still work-in-progress: - https://github.com/openSUSE/openSUSE-docs-revamped-temp/blob/afd610b418f279b426a04b14f1207f2b0261abdc/project/docs/safety_usability.md

Well lets take https://github.com/openSUSE/openSUSE-docs-revamped-temp/blob/dev/project/docs/microos_getting_started.md as an example

I've now found this guide for microos which says not to use full disk encryption as trimming isn't supported for read-only btrfs.

You have convinced me. Would you agree to coordinate with me to consolidate your approach into the revamped openSUSE user guide? The section called "Completing and fine-tuning your setup" could benefit from it.

Material Mk-Docs by Martin Donath works well if you prefer python.

https://squidfunk.github.io/mkdocs-material/

I'm an 'outsider', but from from the outside the Material For MkDocs Project looks like a very well managed open source project.

Martin Donath's project uses a 'sponsorware' release strategy to generate donations.

From my vantage point it seems to be working pretty well.

I just recently went through this decision process. My aim is to write code and math oriented posts so I need good support for nice syntax highlighting (at least colored) and mathjax (preferable) or katex. Substack is the most popular newsletter platform but fails at these two criteria. I love how math and syntax highlighting (plus numerous other features) work in MkDocs Material, which recently added a Blog plugin.

I wanted to combine the best of both: Substack as an amazing email social network, and MkDocs Material’s awesome look. So I’ve gone with using Substack as the core platform which I use to manage subscribers, and use it to post either math/code-free posts or a short teasers pointing to my main blog site on MkDocs Material when I need to show math/code

https://squidfunk.github.io/mkdocs-material/

I've been migrating content to MKDocs (Material) over the last few months, so feel fairly qualified on this subject. It's somewhat limited in terms of navigation, but can probably handle 400-500 pages; you can see how navigation works in the link. Otherwise, it can handle most, if not all, the tasks you've listed.