🚀 The future of Material for MkDocs

tl;dr: Material for MkDocs will switch to a Sponsorware model. New features will first be released exclusively to Sponsors. When a certain Sponsoring goal is reached, these features will be released to the public and be generally available!

---

Material for MkDocs has come a long way. Version 5 brought many improvements and a completely new architecture which makes extension and customization much easier. We haven’t even begun to scratch the surface. After the dust settled and the majority of bugs introduced by the latest major release were fixed, I want to talk about the future.

Where we are

Thanks to all of you who participated in the user survey, we have a pretty good idea of what can be improved and what features are missing or could be better. Additionally, I have tons of ideas on how to improve this project, especially for large (and enterprise) documentation projects. With Material for MkDocs being more popular than ever before, the number of issues and support requests is increasing at a steady pace.

As the original author, I’m doing 99% of maintenance and design work. I want to ensure that issues get fixed quickly and that new useful features make their way into master, but I also have to somehow pay for my living. I’ve invested months and months of my spare time into this project. I’m super excited to see the first sponsors joining, supporting this project, but the collected amount is currently very far from the value of the time I’m putting in this project. With so many big companies using it for their entire front-facing documentation, I’m hoping for more support, to ensure the future of this project!

Where we’re going

This brings me to the announcement I want to make: Material for MkDocs switches to a Sponsorware model! This means:

• New features will first be made available exclusively to sponsors
• Sponsors will be able to propose, discuss and vote, which issues and/or features we’ll tackle next

Of course, some things won’t change:

• Material for MkDocs will remain free and Open Source, forever
• Bugfixes will be addressed as quickly as possible

I’m currently reshaping the Sponsorship tiers to offer something for agency and companies, but from $10 a month, you will be the first to enjoy new features that will increase the value and uniqueness of your documentation project.

What’s up next

The following roadmap shows, at which monthly goals those features will be available to the public:

• $500 | New Search: more relevant search results, more intelligent search summaries, improved search UI/UX
• $1,500 | Versioning: native support to deploy multiple versions of the same documentation
• $3,000 | A new layout: alternative, completely different vertical layout, optimized to read documentation and code side-by-side.

The development will not necessarily be linear, which means that the work on the new layout might start before versioning is completed. I’ve got quite some nice ideas for a new layout, which will also mean an architecture to support multiple layouts!

As always, I’m happy to receive your feedback! Let’s make this project even better, together!

---

If you’re already a sponsor – I’m preparing everything in the background. You’ll be invited to a private repository and a sponsor-only community within the next days. Also, don’t worry about deployment – I’m working on a very simple single-line solution

[wilhelmer]

Sounds exciting. I really hope this works out. You’re doing an outstanding job, and it’s easy to see how much heart and soul you put into this project. Hopefully, companies will be more willing to join the sponsorship if there’s an immediate benefit for them.

Also, don’t be too disappointed with the first outcome of the sponsorship, I think the pace in the enterprise business is a little different, so you can’t expect to put something up and companies are immediately joining in. It takes time. I’ve bugged my supervisor a dozen times about sponsoring you, but it’s a very slow process. (Also, there’s COVID, so companies aren’t exactly enthusiastic about spending money right now.)

[martinbira]

it’s a very slow process. (Also, there’s COVID, so companies aren’t exactly enthusiastic about spending money right now.)

Same thing here. Hopefully these discussions will get moving along once summer and all vacation periods are over here, e.g. late august…