MkDocs Material is now in maintenance mode

As we’re shifting our efforts to Zensical, Material for MkDocs is entering maintenance mode. This means that while we’ll continue to fix critical bugs and security issues for 12 month at least, no new features will be added to Material for MkDocs.

Since Privacy Guides uses MkDocs Material (specifically the Insiders version iirc), are there any plans to switch to their new project called Zensical, or you will just wait and see ?

I made this forum thread just to inform you all :slight_smile:

EDIT: Just made a closer look and it seems that first :

  • You can use mkdocs.yml files directly with Zensical, without changing anything
  • Though, there is no full feature parity : No social cards and blogs for example, *for now*
3 Likes

We are currently taking a look at it.

1 Like

It looks to be they’re having a bit of a re-write with what they learned which does look interesting.

1 Like

That’s a huge part of what we do unfortunately. Blogs especially for our articles and newsletters.

1 Like

Yeah, but they will supposedly come soon. But hey at least you have a full year (12 months) to see what you all could do.

Can’t switch until that is done.


My hope would be to move the knowledge base and recommendations to its own separate website in the same way the EFF has https://ssd.eff.org/ as a standalone resource, and that website would run Zensical. And all the content we make outside of GitHub would move to Ghost.

Hmm, I would have to give that more thought, as the recommendations and knowledgebase are the most important part of the site, I do not know how I feel it becoming a seperate module.

Does it matter whether it is supported for security purposes?

no.

Might be out of the loop proposition, but there are plenty of static generators like Starlight that could fit the job of having some search, cards and features alike without too much effort to migrate to?

Not sure how many edge-case features or work needs to be done but looking at the repo, we mostly have only .md files so should be achievable. :hugs:

We at least only have a frontmatter + regular spec-compliant markdown files to work with, nothing too fancy so that’s already quite sturdy and time proof of a format. :+1:t2: