mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-06-14 11:52:32 +03:00
142 lines
5.3 KiB
Markdown
142 lines
5.3 KiB
Markdown
---
|
||
template: overrides/main.html
|
||
---
|
||
|
||
# <span hidden>Sponsorship</span> :logo: :material-plus: :octicons-heart-fill-24:{: .tx-heart }
|
||
|
||
Material for MkDocs uses the [sponsorware][1] release strategy, which means
|
||
that _new features are first exclusively released to sponsors_ as part of
|
||
__Material for MkDocs Insiders__. Read on to learn [how sponsorship works][2],
|
||
and how you can [become a sponsor][3].
|
||
|
||
[1]: https://github.com/sponsorware/docs
|
||
[2]: #how-sponsorship-works
|
||
[3]: #how-to-become-a-sponsor
|
||
|
||
## How sponsorship works
|
||
|
||
New features will first land in Material for MkDocs Insiders, which means that
|
||
_sponsors will have access immediately_. Every feature is tied to a funding
|
||
goal in monthly subscriptions. If a funding goal is hit, the features that are
|
||
tied to it are merged back into Material for MkDocs and released for general
|
||
availability. Bugfixes will always be released simultaneously in both editions.
|
||
|
||
See the [roadmap][4] for a list of already available and upcoming features, and
|
||
for demonstration purposes, [the official docs][5] built with Material for
|
||
MkDocs Insiders.
|
||
|
||
[4]: #roadmap
|
||
[5]: https://squidfunk.github.io/mkdocs-material-insiders/
|
||
|
||
## How to become a sponsor
|
||
|
||
So you've decided to become a sponsor? Great! You're just __three easy steps__
|
||
away from enjoying the latest features of Material for MkDocs Insiders.
|
||
Complete the following steps and you're in:
|
||
|
||
- Visit [squidfunk's sponsor profile][6] and pick a tier that includes exclusive
|
||
access to squidfunk's sponsorware, which is _any tier above $10/month_. Select
|
||
the tier and complete the checkout.
|
||
- Within 24 hours, you will become a collaborator of the private Material for
|
||
MkDocs Insiders GitHub repository, a fork of Material for MkDocs with
|
||
[brand new and exclusive features][7].
|
||
- Create a [personal access token][8], which allows installing Material for
|
||
MkDocs Insiders from any destination, including other CI providers like
|
||
[GitLab][9] or [Bitbucket][10].
|
||
|
||
__Congratulations! :partying_face: You're now officially a sponsor and will
|
||
get updates for Material for MkDocs Insiders, until you decide to cancel your
|
||
monthly subscription, which you can do at any time.__
|
||
|
||
[6]: https://github.com/sponsors/squidfunk
|
||
[7]: #roadmap
|
||
[8]: https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token
|
||
[9]: https://gitlab.com
|
||
[10]: https://bitbucket.org
|
||
|
||
## Roadmap
|
||
|
||
The following list of funding goals – named after varieties of chili peppers
|
||
[I'm growing on my balcony][11] – shows which features are already available
|
||
in Material for MkDocs Insiders.
|
||
|
||
[11]: https://www.instagram.com/squidfunk/
|
||
|
||
### Madame Jeanette
|
||
|
||
[:octicons-fire-24: Funding goal: __$500__][6] ·
|
||
:octicons-lock-24: Status: _exclusively available_
|
||
|
||
New features and improvements for _search_, including:
|
||
|
||
- [x] Improved search result grouping (pages + headings)
|
||
- [x] Improved search result relevance and scoring
|
||
- [x] Display of missing query terms in search results
|
||
- [ ] Highlighting of query terms on followed page
|
||
- [ ] Improved search result summaries
|
||
- [ ] ... more to come
|
||
|
||
### Prairie Fire
|
||
|
||
[:octicons-fire-24: Funding goal: __$1,000__][6] ·
|
||
:octicons-lock-24: Status: _pending_
|
||
|
||
New features and improvements for _table of contents_, including:
|
||
|
||
- [ ] Table of contents can be moved into navigation for more space
|
||
- [ ] Table of contents shows which sections have search results
|
||
- [ ] Better support for wide screens, i.e. more horizontal space
|
||
- [ ] ... more to come
|
||
|
||
### Bhut Jolokia
|
||
|
||
[:octicons-fire-24: Funding goal: __$1,500__][6] ·
|
||
:octicons-lock-24: Status: _pending_
|
||
|
||
New features and improvements for _hosting multiple versions_, including:
|
||
|
||
- [ ] Support for multiple languages of documents
|
||
- [ ] Support for multiple versions of documents
|
||
- [ ] Support for one or more management plugins
|
||
- [ ] ... more to come
|
||
|
||
### Black Pearl
|
||
|
||
[:octicons-fire-24: Funding goal: __$2,000__][6] ·
|
||
:octicons-lock-24: Status: _pending_
|
||
|
||
New features and improvements for _user preferences_, including:
|
||
|
||
- [ ] Support for user-toggleable themes
|
||
- [ ] Display last searches when search is empty
|
||
- [ ] ... more to come
|
||
|
||
### Caribbean Red
|
||
|
||
[:octicons-fire-24: Funding goal: __$3,000__][6] ·
|
||
:octicons-lock-24: Status: _pending_
|
||
|
||
Alternative, completely different _vertical layout_, optimized to read
|
||
documentation and code side-by-side, e.g. for the documentation of APIs with
|
||
the same functionality as Material for MkDocs.
|
||
|
||
## Terms
|
||
|
||
Whether you're an individual or a company, you may use _Material for MkDocs
|
||
Insiders_ precisely under the same terms as _Material for MkDocs_, which are
|
||
given by the [MIT license][12]. However, we kindly ask you to respect
|
||
the following guidelines:
|
||
|
||
- Please __don't distribute the source code__ from Material for MkDocs Insiders.
|
||
You may freely use it for public, private or commercial projects, fork it,
|
||
mirror it, do whatever you want with it, but please don't release the source
|
||
code, as it would cannibalize the sponsorware strategy.
|
||
|
||
- If you cancel your subscription, you're removed as a collaborator and will
|
||
miss out on future updates of Material for MkDocs Insiders. However, you may
|
||
__use the latest version__ that's available to you __as long as you like__.
|
||
Just remember that __[GitHub deletes private forks][13]__.
|
||
|
||
[12]: license.md
|
||
[13]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository
|