Skip to content

Sunsetting the Insiders program

In April 2023 I announced the launch of a sponsorware program called Insiders, for mkdocstrings and other projects of mine. After two years and a half, I reached a bit more than a thousand dollar in monthly sponsorships, meaning two goals were completed, the $500 and $1000 goals, and their 20 associated features and projects released to the public. Today I'm sunsetting the Insiders program, for a few reasons listed below.


What is the Insiders program?¤

The "Insiders" sponsorware strategy is an interesting approach to open-source projects funding, allowing authors/maintainers to work full-time on these projects, given enough monthly sponsorships. Sponsors fund new features, get immediate access when they are implemented, and the features eventually become available to everyone. Everybody wins: the software is maintained and grows, sponsors get something in return for their funding, all users eventually benefit from the exchange.

Why do I sunset it?¤

This sponsorware strategy has a few drawbacks. First, it's quite a setup: twice as much repositories (public and private versions), which is OK when you maintain only one, but not when you maintain 10 or more. You must be careful with versioning (keeping private versions up-to-date with public ones), with CI (private repositories on GitHub don't have the same CI-minutes allowance), with compatibility (a configured Insiders feature must not crash a public version of the project and instead be a no-op), with documentation, etc.. Merging back private features into public projects is not trivial either. Using Git is almost impossible, unless you have the most disciplined Git history ever (which I don't). The best way to merge back features is basically to cp -r private-project/* public-project/ and then stage the relevant features and associated tests, documentation, and other changes. It takes time and is error-prone.

Second, because it doesn't scale well. The more popular your projects get, the more user-support you have to do, like answering questions, triaging issues, updating documentation, etc.. And with this funding model, user-support stays free. Maybe a better approach would be to let users pay for support instead of funding features?

The complexity of the setup and the fact that it doesn't scale well is one reason I'm sunsetting the Insiders program. The other reason is that, even though some users and companies will start sponsoring you, you still have to promote yourself, reach out to companies, and do a bit of marketing if you want to get sponsorships, depending on the success/popularity of your project, and... that's not my cup of tea. I've always loved the programming side of things, and less the marketing one.

Another reason is that my most popular project, the one for which I get most of the sponsorships, is mkdocstrings (and its ecosystem). But mkdocstrings entirely relies on MkDocs, and MkDocs is unmaintained. This won't come as a surprise for some of you, who raised questions about its maintenance in the MkDocs discussions board. MkDocs hasn't seen a new release in more than a year now. Some critical issues remain unaddressed. I don't feel like MkDocs has a bright future anymore, and relying on it (both technically and financially) seems brittle.

New endeavour¤

There's a new project that might have a brighter future though! It's called Zensical, led by the creator of Material for MkDocs together with his team. And I'm now part of Zensical's core team! My initial focus is bringing first-class API documentation functionality to Zensical, just like I did for MkDocs with mkdocstrings, and we plan to do much more together over time. I've been in touch with Martin for a long time and have followed Zensical's progress closely: I am amazed by the quality of his work and absolutely convinced Zensical is an S-tier project that will make you forget the alternatives. I won't say much more: go check the announcement 🙂!

Another factor in sunsetting Insiders is a deliberate reallocation of my time: I believe my energy is better spent working as a team with Zensical's core contributors than continuing to invest in a stack that shows signs of stagnation. This isn't about a lack of time, it's about choosing the highest-impact work.

What happens to mkdocstrings?¤

I'll be working at Zensical but I'll continue maintaining my open-source projects. Specifically, I'll keep maintaining mkdocstrings for something like a year at least, giving you time to try and switch to Zensical.

If you like my work regardless of mkdocstrings, you can of course continue to sponsor me and fund my open-source work.


Thank you to all my current and past sponsors, especially Material for MkDocs, FastAPI, Pydantic Logfire and Quansight Labs! All the features and projects listed below came to life thanks to you, as well as the countless bug fixes, documentation updates and all the maintenance of all my open-source projects. Thank you ❤️

What we achieved¤

Two funding goals were reached, the $500 and $1000 per month goals. All the associated features and projects are already available to the public. The next two goals weren't reached. As I'm sunsetting the Insiders program, I will start releasing all their associated features and projects too. They should all be available to everyone in something like a week.

Comments