mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-11-27 17:00:54 +01:00
Created new and better Insiders documentation (#7210)
* Updated Insiders documentation * Updated Insiders documentation
This commit is contained in:
parent
1b346eb57b
commit
86d3729a62
204
docs/insiders/access-management.md
Normal file
204
docs/insiders/access-management.md
Normal file
@ -0,0 +1,204 @@
|
|||||||
|
# Access management
|
||||||
|
|
||||||
|
The Material for MkDocs Insiders repository is a private repository hosted on
|
||||||
|
GitHub and access is, therefore, managed through GitHub. This section covers
|
||||||
|
everything you need to know in order to gain access to the private Material for
|
||||||
|
MkDocs Insiders repository.
|
||||||
|
|
||||||
|
## How to get access
|
||||||
|
|
||||||
|
As the private Material for MkDocs Insiders repository is hosted on GitHub, you
|
||||||
|
require a GitHub account to become a sponsor and to gain access. After
|
||||||
|
sponsoring us on one of our [sponsoring tiers] starting at [$15 a month],
|
||||||
|
you'll get access to the private Insiders repository.
|
||||||
|
|
||||||
|
Please note that the process of gaining access is only partially automatable due
|
||||||
|
to technical reasons. Depending on the type of account you've used to become a
|
||||||
|
sponsor, we might need more information from you before we can grant access.
|
||||||
|
|
||||||
|
[$15 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638
|
||||||
|
[sponsoring tiers]: sponsoring-tiers.md
|
||||||
|
|
||||||
|
### Individuals
|
||||||
|
|
||||||
|
If you sponsor using a [personal account], you will receive an invitation link
|
||||||
|
via email to the private Material for MkDocs Insiders repository immediately
|
||||||
|
after initiating your sponsorship. This link is [valid for seven days]. Once you
|
||||||
|
accept the invitation, you'll be ready to [get started].
|
||||||
|
|
||||||
|
If the link expired, please contact us at sponsors@squidfunk.com and we'll
|
||||||
|
send you a new one.
|
||||||
|
|
||||||
|
[personal account]: https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts#personal-accounts
|
||||||
|
[valid for seven days]: #expired-invitations
|
||||||
|
[get started]: getting-started.md
|
||||||
|
|
||||||
|
### Organizations
|
||||||
|
|
||||||
|
When sponsoring using an [organization account], GitHub will not send an
|
||||||
|
automated invitation via email to access the private Material for MkDocs Insiders
|
||||||
|
repository. Due to [GitHub limitations], granting access to a private repository
|
||||||
|
for an entire organization is not possible.
|
||||||
|
|
||||||
|
Therefore, please contact us at sponsors@squidfunk.com with the name of a
|
||||||
|
[personal account] or the name of a [bot account] that is publicly or privately
|
||||||
|
listed as an owner of your GitHub organization after you received a confirmation
|
||||||
|
that your sponsorship was initiated.
|
||||||
|
|
||||||
|
We will add this designated account as a collaborator, and once the invitation
|
||||||
|
is [accepted within seven days], your organization will be all set to [get
|
||||||
|
started].
|
||||||
|
|
||||||
|
[organization account]: https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts#organization-accounts
|
||||||
|
[GitHub limitations]: #collaborators
|
||||||
|
[bot account]: #bot-account
|
||||||
|
[accepted within seven days]: #expired-invitations
|
||||||
|
|
||||||
|
### Enterprises
|
||||||
|
|
||||||
|
If you would like to sponsor us using an [enterprise account], we recommend
|
||||||
|
using a [personal account] or a [bot account] to initiate the sponsorship and
|
||||||
|
access the private Material for MkDocs Insiders repository using this account.
|
||||||
|
|
||||||
|
[enterprise account]: https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts#enterprise-accounts
|
||||||
|
|
||||||
|
## Restrictions
|
||||||
|
|
||||||
|
GitHub sets limitations beyond our control, which is why we require further
|
||||||
|
information regarding [collaborators] of private repositories and [matching] of
|
||||||
|
GitHub accounts.
|
||||||
|
|
||||||
|
[collaborators]: #collaborators
|
||||||
|
[matching]: #matching
|
||||||
|
|
||||||
|
### Collaborators
|
||||||
|
|
||||||
|
GitHub policy limits access to [private repositories] to [personal accounts]
|
||||||
|
only, which is why it is currently not possible for us to add [organization
|
||||||
|
accounts] to the Material for MkDocs Insiders repository – a private
|
||||||
|
repository.
|
||||||
|
|
||||||
|
As much as we would love to give each member of your organization access, it's
|
||||||
|
simply not feasible for us to add each member account, which is why every
|
||||||
|
[sponsoring tier] is limited to one seat. However, you can use a [bot account]
|
||||||
|
to work around this limitation.
|
||||||
|
|
||||||
|
[private repositories]: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository
|
||||||
|
[personal accounts]: https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts#personal-accounts
|
||||||
|
[organization accounts]: https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts#organization-accounts
|
||||||
|
[sponsoring tier]: sponsoring-tiers.md
|
||||||
|
[team management]: #team-management
|
||||||
|
|
||||||
|
### Matching
|
||||||
|
|
||||||
|
Due to privacy reasons, GitHub does not allow email addresses to be matched with
|
||||||
|
GitHub accounts. When requesting access via email at sponsors@squidfunk.com,
|
||||||
|
it's necessary to provide us with the name of a [personal account].
|
||||||
|
|
||||||
|
## Bot account
|
||||||
|
|
||||||
|
Given that only personal accounts can be listed as collaborators on
|
||||||
|
[private repositories], ensuring access for an entire organization requires
|
||||||
|
coordination through individuals. Changes within the team could lead to losing
|
||||||
|
access to the entire organization.
|
||||||
|
|
||||||
|
To avoid this, you have the option to create a bot account, which is
|
||||||
|
[a new personal account] that does not belong to a specific individual but is
|
||||||
|
publicly or privately listed as the owner of the GitHub organization
|
||||||
|
|
||||||
|
Using a bot account for access management and initiating your [public] or
|
||||||
|
[private] sponsorship through it also allows for better attribution of
|
||||||
|
sponsorship costs, allowing you to manage access and payment for all
|
||||||
|
sponsorships through a single account, and is thus recommended.
|
||||||
|
|
||||||
|
[a new personal account]: https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github
|
||||||
|
[public]: privacy.md/#public-sponsors
|
||||||
|
[private]: privacy.md/#private-sponsors
|
||||||
|
|
||||||
|
## Expired invitations
|
||||||
|
|
||||||
|
The invitation to the private Material for MkDocs is valid for seven days, a
|
||||||
|
limitation imposed by GitHub. If invitations are not accepted within this
|
||||||
|
period, you'll need to contact us via mail at sponsors@squidfunk.com, and we
|
||||||
|
will re-issue the invitation immediately.
|
||||||
|
|
||||||
|
## Team management
|
||||||
|
|
||||||
|
If you are using Material for MkDocs Insiders as an [individual] and don't
|
||||||
|
collaborate with other users, [forking] the private repository is not necessary.
|
||||||
|
However, when working with a team, it is not possible to simply share your
|
||||||
|
collaborator status with other accounts. Therefore, in order to work in a team,
|
||||||
|
the account with access to Insiders can [fork], [clone], or [mirror] the private
|
||||||
|
Material for MkDocs Insiders repository to an organization, providing a pathway
|
||||||
|
for team collaboration.
|
||||||
|
|
||||||
|
[fork]: #forking
|
||||||
|
[clone]: #cloning
|
||||||
|
[mirror]: #mirroring
|
||||||
|
[individual]: #individuals
|
||||||
|
|
||||||
|
### Outside collaborators
|
||||||
|
|
||||||
|
When working with outside collaborators, you should know that the Insiders
|
||||||
|
edition is compatible with the community edition. All new features and
|
||||||
|
configuration options are backward-compatible or implemented behind feature
|
||||||
|
flags. Most Insiders features enhance the overall experience, e.g., by creating
|
||||||
|
better social cards or instant previews. While these features add value for your
|
||||||
|
site's users, they are most certainly not necessary for previewing your site.
|
||||||
|
|
||||||
|
This means that outside collaborators can build the documentation locally with
|
||||||
|
the community edition, and when they push their changes, your CI pipeline will
|
||||||
|
build it with Insiders. When using [built-in plugins] exclusive to Insiders, we
|
||||||
|
recommend using the [group] plugin.
|
||||||
|
|
||||||
|
See the [getting started guide] for more information.
|
||||||
|
[getting started guide]: getting-started.md
|
||||||
|
[built-in plugins]: index.md#built-in-plugins
|
||||||
|
[group]: ../plugins/group.md
|
||||||
|
|
||||||
|
### Forking
|
||||||
|
|
||||||
|
[Forking] a repository creates a copy of the repository that allows for
|
||||||
|
independent development while maintaining a link to the original repository
|
||||||
|
for updates.
|
||||||
|
|
||||||
|
[forking]: https://docs.github.com/en/get-started/quickstart/fork-a-repo
|
||||||
|
|
||||||
|
### Cloning
|
||||||
|
|
||||||
|
[Cloning] a repository copies the repository to your local machine or codespace,
|
||||||
|
facilitating offline work and content management. You can, of course, also
|
||||||
|
[clone a private fork].
|
||||||
|
|
||||||
|
[cloning]: https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository
|
||||||
|
[clone a private fork]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#cloning-your-forked-repository
|
||||||
|
|
||||||
|
### Mirroring
|
||||||
|
|
||||||
|
[Mirroring] a repository creates an identical copy, ensuring you have the
|
||||||
|
flexibility to host and work with the repository [in other environments] besides
|
||||||
|
GitHub. This is a particularly useful strategy for organizations hosting their
|
||||||
|
repositories in a private environment outside of GitHub.
|
||||||
|
|
||||||
|
[mirroring]: https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository
|
||||||
|
[in other environments]: #github-alternatives
|
||||||
|
|
||||||
|
## GitHub alternatives
|
||||||
|
|
||||||
|
Material for MkDocs Insiders is designed to be compatible with various
|
||||||
|
repository hosting platforms, including GitLab. The key requirement is still a
|
||||||
|
GitHub account, as we use GitHub Sponsors for transactions and GitHub to manage access to the private Insiders repository.
|
||||||
|
|
||||||
|
Once you've become a sponsor and secured access to the private Insiders
|
||||||
|
repository via an individual GitHub account, you can [mirror the repository in
|
||||||
|
another location]. This mirroring process not only allows for easy integration
|
||||||
|
into your existing workflow but also ensures that your projects stay up-to-date
|
||||||
|
with the latest features and improvements of Insiders.
|
||||||
|
|
||||||
|
Our discussion board is a valuable resource for any questions about integrating
|
||||||
|
Material for MkDocs Insiders into your projects. It offers a space to connect
|
||||||
|
with others who may have similar requirements and setups, as well as to
|
||||||
|
exchange tips and explore solutions together.
|
||||||
|
|
||||||
|
[mirror the repository in another location]: https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-in-another-location
|
||||||
|
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
|
343
docs/insiders/benefits.md
Normal file
343
docs/insiders/benefits.md
Normal file
@ -0,0 +1,343 @@
|
|||||||
|
# What’s in it for you
|
||||||
|
|
||||||
|
Material for MkDocs Insiders is packed with additional features that are
|
||||||
|
exclusively available to our monthly sponsors – the moment you become a sponsor,
|
||||||
|
you'll gain __immediate access__ to all the exclusive Insiders features, ready
|
||||||
|
for you to __start using now__.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
Our sponsors currently enjoy access to the following 26 additional features. New
|
||||||
|
features are added regularly, so be sure to check back regularly to stay
|
||||||
|
updated.
|
||||||
|
|
||||||
|
<div class="mdx-columns" markdown>
|
||||||
|
|
||||||
|
- [x] [Blog plugin: pinned posts] :material-alert-decagram:{ .mdx-pulse title="Added on February 24, 2024" }
|
||||||
|
- [x] [Instant previews] :material-alert-decagram:{ .mdx-pulse title="Added on January 28, 2024" }
|
||||||
|
- [x] [Footnote tooltips] :material-alert-decagram:{ .mdx-pulse title="Added on January 24, 2024" }
|
||||||
|
- [x] [Tags plugin: advanced settings]
|
||||||
|
- [x] [Tags plugin: nested tags]
|
||||||
|
- [x] [Tags plugin: shadow tags]
|
||||||
|
- [x] [Stay on page when switching languages]
|
||||||
|
- [x] [Blog plugin: author profiles]
|
||||||
|
- [x] [Blog plugin: advanced settings]
|
||||||
|
- [x] [Projects plugin]
|
||||||
|
- [x] [Instant prefetching]
|
||||||
|
- [x] [Social plugin: custom layouts]
|
||||||
|
- [x] [Social plugin: background images]
|
||||||
|
- [x] [Code range selection]
|
||||||
|
- [x] [Code annotations: custom selectors]
|
||||||
|
- [x] [Privacy plugin: advanced settings]
|
||||||
|
- [x] [Optimize plugin]
|
||||||
|
- [x] [Navigation path] (Breadcrumbs)
|
||||||
|
- [x] [Typeset plugin]
|
||||||
|
- [x] [Privacy plugin: external links]
|
||||||
|
- [x] [Navigation subtitles]
|
||||||
|
- [x] [Tags plugin: allow list] + [custom sorting]
|
||||||
|
- [x] [Blog plugin: custom index pages]
|
||||||
|
- [x] [Blog plugin: related links]
|
||||||
|
- [x] [Meta plugin]
|
||||||
|
- [x] [Tags plugin: configurable listings]
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## What's coming next
|
||||||
|
|
||||||
|
> Too many ideas, too little time!
|
||||||
|
|
||||||
|
Our backlog is filled with countless ideas that we came up with or that have
|
||||||
|
been suggested by our community. We're also working to make our roadmap public.
|
||||||
|
If you have something specific in mind, and wonder whether we've considered it,
|
||||||
|
feel free to ask on our [discussion board].
|
||||||
|
|
||||||
|
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
|
||||||
|
|
||||||
|
## Frequent releases
|
||||||
|
|
||||||
|
We’re committed to quickly addressing bugs, that come up and keeping our open
|
||||||
|
issue count as low as possible. Both our community and Insiders editions are
|
||||||
|
regularly updated, ensuring you have the latest features and fixes available at
|
||||||
|
all times.
|
||||||
|
|
||||||
|
## Additional benefits
|
||||||
|
|
||||||
|
As a premium sponsors, you'll enjoy additional benefits that are not available
|
||||||
|
to our individual sponsors. When sponsoring our work on one of our [commercial
|
||||||
|
tiers] starting at [$125 a month], you'll get additional benefits that we offer
|
||||||
|
for enterprises:
|
||||||
|
|
||||||
|
- [Prioritized] bug reports to keep your projects running smoothly
|
||||||
|
- Logo placement and backlink on our site for increased visibility
|
||||||
|
- Private support via email for any questions to our maintainers
|
||||||
|
|
||||||
|
[commercial tiers]: sponsoring-tiers.md/#commercial-use
|
||||||
|
[$125 a month]: sponsoring-tiers.md/#the-organization
|
||||||
|
[list of premium sponsors]: https://github.com/squidfunk/mkdocs-material#user-content-premium-sponsors
|
||||||
|
[Prioritized]: ../support.md/#prioritized-support
|
||||||
|
|
||||||
|
----
|
||||||
|
|
||||||
|
Interested in supporting us? Together, let’s continue to make Material for
|
||||||
|
MkDocs an even more powerful tool for everyone. We’re excited for what the
|
||||||
|
future holds!
|
||||||
|
|
||||||
|
[:octicons-heart-fill-24:{ .mdx-heart } Show your support <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][sponsoring tiers]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[sponsoring tiers]: sponsoring-tiers.md#commercial-use
|
||||||
|
|
||||||
|
## Funding <span class="mdx-sponsorship-total" data-mdx-component="sponsorship-total"></span>
|
||||||
|
|
||||||
|
### Goals
|
||||||
|
|
||||||
|
The following section lists all funding goals. Each goal contains a list of
|
||||||
|
features prefixed with a checkmark symbol, denoting whether a feature is
|
||||||
|
:octicons-check-circle-fill-24:{ style="color: #00e676" } already available or
|
||||||
|
:octicons-check-circle-fill-24:{ style="color: var(--md-default-fg-color--lightest)" }
|
||||||
|
planned, but not yet implemented. This means that each funding goal unlocks new
|
||||||
|
features for general availability in the community edition, after sponsors have
|
||||||
|
used them for a while.
|
||||||
|
|
||||||
|
#### $ 16,000 – Chipotle
|
||||||
|
|
||||||
|
- [x] [Meta plugin]
|
||||||
|
- [x] [Blog plugin: related links]
|
||||||
|
- [x] [Blog plugin: custom index pages]
|
||||||
|
- [x] [Tags plugin: configurable listings]
|
||||||
|
- [x] [Tags plugin: allow list] + [custom sorting]
|
||||||
|
- [x] [Navigation subtitles]
|
||||||
|
|
||||||
|
[Meta plugin]: ../plugins/meta.md
|
||||||
|
[Blog plugin: related links]: ../setup/setting-up-a-blog.md#adding-related-links
|
||||||
|
[Blog plugin: custom index pages]: ../setup/setting-up-a-blog.md#custom-index-pages
|
||||||
|
[Tags plugin: configurable listings]: ../setup/setting-up-tags.md#configurable-listings
|
||||||
|
[Tags plugin: allow list]: ../plugins/tags.md#config.tags_allowed
|
||||||
|
[custom sorting]: ../plugins/tags.md#config.tags_sort_by
|
||||||
|
[Navigation subtitles]: ../reference/index.md#setting-the-page-subtitle
|
||||||
|
|
||||||
|
#### $ 18,000 – Lemon Drop
|
||||||
|
|
||||||
|
- [x] [Optimize plugin]
|
||||||
|
- [x] [Navigation path] (Breadcrumbs)
|
||||||
|
- [x] [Blog plugin: advanced settings]
|
||||||
|
- [x] [Blog plugin: author profiles]
|
||||||
|
- [x] [Blog plugin: pinned posts]
|
||||||
|
- [x] [Instant prefetching]
|
||||||
|
|
||||||
|
[Optimize plugin]: ../plugins/optimize.md
|
||||||
|
[Navigation path]: ../setup/setting-up-navigation.md#navigation-path
|
||||||
|
[Blog plugin: advanced settings]: ../setup/setting-up-a-blog.md#advanced-settings
|
||||||
|
[Blog plugin: author profiles]: ../setup/setting-up-a-blog.md#adding-author-profiles
|
||||||
|
[Blog plugin: pinned posts]: ../setup/setting-up-a-blog.md#pinning-a-post
|
||||||
|
[Instant prefetching]: ../setup/setting-up-navigation.md#instant-prefetching
|
||||||
|
|
||||||
|
#### $ 20,000 – Jalapeño
|
||||||
|
|
||||||
|
- [x] [Typeset plugin]
|
||||||
|
- [x] [Footnote tooltips]
|
||||||
|
- [x] [Privacy plugin: advanced settings]
|
||||||
|
- [x] [Privacy plugin: external links]
|
||||||
|
- [ ] to be announced
|
||||||
|
- [ ] to be announced
|
||||||
|
|
||||||
|
[Typeset plugin]: ../plugins/typeset.md
|
||||||
|
[Footnote tooltips]: ../reference/footnotes.md#footnote-tooltips
|
||||||
|
[Privacy plugin: external links]: ../plugins/privacy.md#external-links
|
||||||
|
[Privacy plugin: advanced settings]: ../setup/ensuring-data-privacy.md#advanced-settings
|
||||||
|
|
||||||
|
#### $ 22,000 – Habanero Orange
|
||||||
|
|
||||||
|
- [x] [Instant previews]
|
||||||
|
- [x] [Social plugin: custom layouts]
|
||||||
|
- [x] [Social plugin: background images]
|
||||||
|
- [x] [Code range selection]
|
||||||
|
- [x] [Code annotations: custom selectors]
|
||||||
|
- [x] [Stay on page when switching languages]
|
||||||
|
|
||||||
|
[Instant previews]: ../setup/setting-up-navigation.md#instant-previews
|
||||||
|
[Social plugin: custom layouts]: ../setup/setting-up-social-cards.md#customization
|
||||||
|
[Social plugin: background images]: ../plugins/social.md#option.background_image
|
||||||
|
[Code range selection]: ../reference/code-blocks.md#code-selection-button
|
||||||
|
[Code annotations: custom selectors]: ../reference/code-blocks.md#custom-selectors
|
||||||
|
[Stay on page when switching languages]: ../setup/changing-the-language.md#stay-on-page
|
||||||
|
|
||||||
|
#### $ 24,000 – Blockpaprika
|
||||||
|
|
||||||
|
- [x] [Projects plugin]
|
||||||
|
- [x] [Tags plugin: nested tags]
|
||||||
|
- [x] [Tags plugin: shadow tags]
|
||||||
|
- [x] [Tags plugin: advanced settings]
|
||||||
|
- [ ] to be announced
|
||||||
|
- [ ] to be announced
|
||||||
|
|
||||||
|
[Projects plugin]: ../plugins/projects.md
|
||||||
|
[Tags plugin: nested tags]: ../setup/setting-up-tags.md#nested-tags
|
||||||
|
[Tags plugin: shadow tags]: ../setup/setting-up-tags.md#shadow-tags
|
||||||
|
[Tags plugin: advanced settings]: ../setup/setting-up-tags.md#advanced-settings
|
||||||
|
|
||||||
|
### Goals completed
|
||||||
|
|
||||||
|
This section celebrates the milestones we’ve achieved thanks to our incredible
|
||||||
|
sponsors. Those features were once part of Material for MkDocs Insiders, and
|
||||||
|
therefore only available to our sponsors, and are now generally available to
|
||||||
|
be used by all users.
|
||||||
|
|
||||||
|
#### $ 14,000 – Goat's Horn
|
||||||
|
|
||||||
|
- [x] [Privacy plugin]
|
||||||
|
- [x] [Card grids]
|
||||||
|
- [x] [Tooltips]
|
||||||
|
- [x] [Content tabs: anchor links]
|
||||||
|
- [x] [Automatic light / dark mode]
|
||||||
|
- [x] [Document contributors]
|
||||||
|
|
||||||
|
[Privacy plugin]: ../setup/ensuring-data-privacy.md#built-in-privacy-plugin
|
||||||
|
[Card grids]: ../reference/grids.md
|
||||||
|
[Tooltips]: ../reference/tooltips.md
|
||||||
|
[Content tabs: anchor links]: ../reference/content-tabs.md#anchor-links
|
||||||
|
[Automatic light / dark mode]: ../setup/changing-the-colors.md#automatic-light-dark-mode
|
||||||
|
[Document contributors]: ../setup/adding-a-git-repository.md#document-contributors
|
||||||
|
|
||||||
|
#### $ 12,000 – Piri Piri
|
||||||
|
|
||||||
|
- [x] [Blog plugin]
|
||||||
|
- [x] [Chinese search support]
|
||||||
|
- [x] [Annotations]
|
||||||
|
- [x] [Navigation icons]
|
||||||
|
- [x] [Navigation pruning]
|
||||||
|
- [x] [Navigation status]
|
||||||
|
|
||||||
|
[Blog plugin]: ../setup/setting-up-a-blog.md
|
||||||
|
[Chinese search support]: ../blog/posts/chinese-search-support.md
|
||||||
|
[Annotations]: ../reference/annotations.md
|
||||||
|
[Navigation icons]: ../reference/index.md#setting-the-page-icon
|
||||||
|
[Navigation pruning]: ../setup/setting-up-navigation.md#navigation-pruning
|
||||||
|
[Navigation status]: ../reference/index.md#setting-the-page-status
|
||||||
|
|
||||||
|
#### $ 10,000 – Carolina Reaper
|
||||||
|
|
||||||
|
- [x] [Brand new search plugin]
|
||||||
|
- [x] [Rich search previews]
|
||||||
|
- [x] [Tokenizer with lookahead]
|
||||||
|
- [x] [Advanced search highlighting]
|
||||||
|
- [x] [Excluding content from search]
|
||||||
|
- [x] [Offline plugin]
|
||||||
|
|
||||||
|
[Brand new search plugin]: ../blog/posts/search-better-faster-smaller.md
|
||||||
|
[Rich search previews]: ../blog/posts/search-better-faster-smaller.md#rich-search-previews
|
||||||
|
[Tokenizer with lookahead]: ../blog/posts/search-better-faster-smaller.md#tokenizer-lookahead
|
||||||
|
[Advanced search highlighting]: ../blog/posts/search-better-faster-smaller.md#accurate-highlighting
|
||||||
|
[Excluding content from search]: ../setup/setting-up-site-search.md#search-exclusion
|
||||||
|
[Offline plugin]: ../setup/building-for-offline-usage.md
|
||||||
|
|
||||||
|
#### $ 8,000 – Scotch Bonnet
|
||||||
|
|
||||||
|
- [x] [Social cards]
|
||||||
|
- [x] Code annotations: anchor links
|
||||||
|
- [x] [Code annotations: strip comments]
|
||||||
|
- [x] [Tag icons]
|
||||||
|
- [x] [Table of contents anchor following]
|
||||||
|
- [x] Sidebars automatically scroll to active item
|
||||||
|
|
||||||
|
[Social cards]: ../setup/setting-up-social-cards.md
|
||||||
|
[Code annotations: strip comments]: ../reference/code-blocks.md#stripping-comments
|
||||||
|
[Tag icons]: ../setup/setting-up-tags.md#tag-icons-and-identifiers
|
||||||
|
[Table of contents anchor following]: ../setup/setting-up-navigation.md#anchor-following
|
||||||
|
|
||||||
|
#### $ 7,000 – Royal Gold
|
||||||
|
|
||||||
|
- [x] [Cookie consent]
|
||||||
|
- [x] [Was this page helpful?]
|
||||||
|
- [x] [Dismissable announcement bar]
|
||||||
|
|
||||||
|
[Cookie consent]: ../setup/ensuring-data-privacy.md#cookie-consent
|
||||||
|
[Was this page helpful?]: ../setup/setting-up-site-analytics.md#was-this-page-helpful
|
||||||
|
[Dismissable announcement bar]: ../setup/setting-up-the-header.md#mark-as-read
|
||||||
|
|
||||||
|
#### $ 6,000 – Trinidad Scorpion
|
||||||
|
|
||||||
|
- [x] [Boosting pages in search]
|
||||||
|
- [x] [Custom admonition icons]
|
||||||
|
- [x] [Linking content tabs]
|
||||||
|
|
||||||
|
[Boosting pages in search]: ../setup/setting-up-site-search.md#search-boosting
|
||||||
|
[Custom admonition icons]: ../reference/admonitions.md#admonition-icons
|
||||||
|
[Linking content tabs]: ../reference/content-tabs.md#linked-content-tabs
|
||||||
|
|
||||||
|
#### $ 5,000 – Aji Panca
|
||||||
|
|
||||||
|
- [x] [Mermaid.js integration]
|
||||||
|
- [x] Stay on page when switching versions
|
||||||
|
- [x] [Tags with search integration]
|
||||||
|
|
||||||
|
[Mermaid.js integration]: ../reference/diagrams.md
|
||||||
|
[Tags with search integration]: ../setup/setting-up-tags.md
|
||||||
|
|
||||||
|
#### $ 4,000 – Ghost Pepper
|
||||||
|
|
||||||
|
- [x] [Anchor tracking]
|
||||||
|
- [x] [Code annotations]
|
||||||
|
- [x] [Version warning]
|
||||||
|
|
||||||
|
[Anchor tracking]: ../setup/setting-up-navigation.md#anchor-tracking
|
||||||
|
[Code annotations]: ../reference/code-blocks.md#adding-annotations
|
||||||
|
[Version warning]: ../setup/setting-up-versioning.md#version-warning
|
||||||
|
|
||||||
|
#### $ 3,000 – Caribbean Red
|
||||||
|
|
||||||
|
- [x] [Sticky navigation tabs]
|
||||||
|
- [x] [Section index pages]
|
||||||
|
- [x] [Remove generator notice]
|
||||||
|
|
||||||
|
[Sticky navigation tabs]: ../setup/setting-up-navigation.md#sticky-navigation-tabs
|
||||||
|
[Section index pages]: ../setup/setting-up-navigation.md#section-index-pages
|
||||||
|
[Remove generator notice]: ../setup/setting-up-the-footer.md#generator-notice
|
||||||
|
|
||||||
|
#### $ 2,500 – Biquinho Vermelho
|
||||||
|
|
||||||
|
- [x] [Search suggestions]
|
||||||
|
- [x] [Search highlighting]
|
||||||
|
- [x] [Search sharing]
|
||||||
|
|
||||||
|
[Search suggestions]: ../setup/setting-up-site-search.md#search-suggestions
|
||||||
|
[Search highlighting]: ../setup/setting-up-site-search.md#search-highlighting
|
||||||
|
[Search sharing]: ../setup/setting-up-site-search.md#search-sharing
|
||||||
|
|
||||||
|
#### $ 2,000 – Black Pearl
|
||||||
|
|
||||||
|
- [x] Latest release tag
|
||||||
|
- [x] [Color palette toggle]
|
||||||
|
- [x] [Back-to-top button]
|
||||||
|
|
||||||
|
[Color palette toggle]: ../setup/changing-the-colors.md#color-palette-toggle
|
||||||
|
[Back-to-top button]: ../setup/setting-up-navigation.md#back-to-top-button
|
||||||
|
|
||||||
|
#### $ 1,500 – Bhut Jolokia
|
||||||
|
|
||||||
|
- [x] [Admonition inline blocks]
|
||||||
|
- [x] [Site language selection]
|
||||||
|
- [x] [Versioning]
|
||||||
|
|
||||||
|
[Admonition inline blocks]: ../reference/admonitions.md#inline-blocks
|
||||||
|
[Site language selection]: ../setup/changing-the-language.md#site-language-selector
|
||||||
|
[Versioning]: ../setup/setting-up-versioning.md#versioning
|
||||||
|
|
||||||
|
#### $ 1,000 – Prairie Fire
|
||||||
|
|
||||||
|
- [x] [Navigation sections]
|
||||||
|
- [x] [Navigation expansion]
|
||||||
|
- [x] [Hiding the sidebars]
|
||||||
|
- [x] [Table of contents in navigation]
|
||||||
|
- [x] [Header hides on scroll]
|
||||||
|
|
||||||
|
[Navigation sections]: ../setup/setting-up-navigation.md#navigation-sections
|
||||||
|
[Navigation expansion]: ../setup/setting-up-navigation.md#navigation-expansion
|
||||||
|
[Hiding the sidebars]: ../setup/setting-up-navigation.md#hiding-the-sidebars
|
||||||
|
[Table of contents in navigation]: ../setup/setting-up-navigation.md#navigation-integration
|
||||||
|
[Header hides on scroll]: ../setup/setting-up-the-header.md#automatic-hiding
|
||||||
|
|
||||||
|
#### $ 500 – Madame Jeanette
|
||||||
|
|
||||||
|
- [x] Improved search result grouping
|
||||||
|
- [x] Improved search result relevance and scoring
|
||||||
|
- [x] Missing query terms in search results
|
@ -1,585 +0,0 @@
|
|||||||
# Sponsoring FAQs
|
|
||||||
|
|
||||||
Do you have questions about Material for MkDocs Insiders? We do our best to
|
|
||||||
answer all of your questions on this page. If you can't find your question
|
|
||||||
below, ask it on our [discussion board]!
|
|
||||||
|
|
||||||
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions/new/chooses
|
|
||||||
|
|
||||||
## General
|
|
||||||
|
|
||||||
[__Why did we create Material for MkDocs Insiders?__](#insiders-edition){ #insiders-edition }
|
|
||||||
|
|
||||||
So, here's the deal: Material for MkDocs began as a passion project, which we
|
|
||||||
made open-source to share freely with everyone. However, as the project's
|
|
||||||
popularity grew over the last few years, so did the demands of its maintenance
|
|
||||||
and overhead. Faced with the growing demands and the tough choice between
|
|
||||||
discontinuing our efforts or dedicating ourselves full-time, we chose to commit
|
|
||||||
ourselves fully to the project.
|
|
||||||
|
|
||||||
To sustain this full-time commitment and to expand the team, we introduced
|
|
||||||
Material for MkDocs Insiders. This private Insiders repository, available
|
|
||||||
exclusively to our monthly sponsors, is where we first release the latest
|
|
||||||
advancements of Material for MkDocs. That way our sponsors get the
|
|
||||||
[premium features] in advance of all others users as a thank you for their
|
|
||||||
support. But here's the best part: once we achieve specific funding goals, these
|
|
||||||
advancements become available to the wider community. This model ensures ongoing
|
|
||||||
development and accessibility for all, keeping the project vibrant and
|
|
||||||
up-to-date.
|
|
||||||
|
|
||||||
We communicate these [funding goals] and their progress openly, ensuring our
|
|
||||||
community is involved every step of the way. It's our way of making sure that
|
|
||||||
while we do need the support to keep going, everyone will eventually benefit
|
|
||||||
from the advancements made possible by our sponsors.
|
|
||||||
|
|
||||||
[funding goals]: ../index.md/#funding
|
|
||||||
[premium features]: ../index.md/#whats-in-it-for-me
|
|
||||||
|
|
||||||
|
|
||||||
[__Why is the Insiders offered as a subscription model?__](#subscription-model){ #subscription-model }
|
|
||||||
|
|
||||||
You might wonder why we opted for a subscription model for the Insiders edition
|
|
||||||
instead of a one-time purchase. Here's the thing: Material for MkDocs is in
|
|
||||||
constant evolution. Our work is never done because there's always something new
|
|
||||||
on the horizon – be it adapting to upstream dependency updates, keeping pace
|
|
||||||
with environment changes like browser updates, or bringing to life
|
|
||||||
the new features and improvements our users wish for.
|
|
||||||
|
|
||||||
A one-time payment might seem appealing at first glance, but it's a bit like
|
|
||||||
buying a snapshot: great for a moment, but it doesn't stay current for long.
|
|
||||||
With a subscription, you're not just buying what's already been developed;
|
|
||||||
you're investing in what's coming next. You get all the future updates, bug
|
|
||||||
fixes, and new features as they roll out. This ongoing development is crucial
|
|
||||||
not just for keeping the project alive and kicking but for ensuring it
|
|
||||||
continues to meet your needs and expectations.
|
|
||||||
|
|
||||||
This subscription model is what enables us to dedicate the necessary time and
|
|
||||||
resources to Material for MkDocs, ensuring its sustainability and growth. It's
|
|
||||||
about more than just maintaining the status quo; it's about pushing boundaries,
|
|
||||||
improving, and innovating. When we hit our funding goals through these monthly
|
|
||||||
subscriptions, we will roll out the Insiders features to the community edition.
|
|
||||||
That way, the whole community benefits from the advancements made possible by
|
|
||||||
our supporters.
|
|
||||||
|
|
||||||
In essence, the subscription is a commitment to not just maintaining but
|
|
||||||
actively developing Material for MkDocs. It allows us to plan for the future
|
|
||||||
with confidence, knowing we have the backing to continue our work. This model
|
|
||||||
has made all the difference, enabling us to rely on our sponsors' ongoing
|
|
||||||
support and ensuring that Material for MkDocs remains a cutting-edge tool for
|
|
||||||
everyone.
|
|
||||||
|
|
||||||
[__What features are included in the Insiders edition?__](#insiders-features){ #insiders-features }
|
|
||||||
|
|
||||||
The Insiders edition includes more than 20 additional features. You can find an
|
|
||||||
[overview of these features] on our [Insiders page], which is updated when new
|
|
||||||
features are added and released.
|
|
||||||
|
|
||||||
[Insiders page]: ../index.md
|
|
||||||
[overview of these features]: ../index.md#whats-in-it-for-me
|
|
||||||
|
|
||||||
[__How often is the Insiders edition updated?__](#insiders-updates){ #insiders-updates }
|
|
||||||
|
|
||||||
We try to keep our open issue count low, fixing known bugs quickly. Both our
|
|
||||||
repositories, the community and Insiders edition, are constantly updated with
|
|
||||||
bug fixes and new features.
|
|
||||||
|
|
||||||
## Sponsorship
|
|
||||||
|
|
||||||
[__Can I sponsor the project without a GitHub account?__](#sponsorship-account){ #sponsorship-account }
|
|
||||||
|
|
||||||
No, you can't support Material for MkDocs if you don't have a GitHub account.
|
|
||||||
GitHub Sponsors handles all transactions and access management for us. Please
|
|
||||||
also note that the private Insiders repository is on GitHub, so in order to gain
|
|
||||||
access, you'll need to have a GitHub individual or bot account that can be added
|
|
||||||
as a collaborator. If your organization doesn't use GitHub or hosts its
|
|
||||||
repositories on other platforms, you can mirror the Insiders repository in your
|
|
||||||
environment once you have access.
|
|
||||||
|
|
||||||
[__We are hosting our repository on Gitlab, can we also use Insiders?__](#github-alternatives){ #github-alternatives }
|
|
||||||
|
|
||||||
Absolutely! Material for MkDocs Insiders is designed to be compatible with
|
|
||||||
various repository hosting platforms, including GitLab. The key requirement is
|
|
||||||
still a GitHub account, as we use GitHub Sponsors for all transactions and
|
|
||||||
manage access to the private Insiders repository through GitHub.
|
|
||||||
|
|
||||||
Once you've become a sponsor and secured access to the private Insiders
|
|
||||||
repository via an individual GitHub account, you can
|
|
||||||
[mirror the repository in another location]. This mirroring process not only
|
|
||||||
allows for easy integration into your existing workflow but also ensures that
|
|
||||||
your projects stay up-to-date with the latest features and improvements of
|
|
||||||
Material for MkDocs Insiders.
|
|
||||||
|
|
||||||
For any questions about integrating Material for MkDocs Insiders into your
|
|
||||||
projects, our [discussion board] is a valuable resource. It offers a space to
|
|
||||||
connect with others who may have similar requirements and setups as well as to
|
|
||||||
exchange tips, and explore solutions together.
|
|
||||||
|
|
||||||
[mirror the repository in another location]: https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-in-another-location
|
|
||||||
|
|
||||||
[__Which sponsoring tier should I choose?__](#sponsorship-tier){ #sponsorship-tier }
|
|
||||||
|
|
||||||
The sponsoring tiers are divided into [non-commercial] and [commercial] tiers. If
|
|
||||||
you are an individual or organization using Material for MkDocs for private or
|
|
||||||
__non-commercial__ Open Source projects, you have two tiers to choose from,
|
|
||||||
depending on the number of sites you want to build. For companies using
|
|
||||||
Material for MkDocs, we offer three different __commercial__ tiers, from which
|
|
||||||
you can choose depending on your requirements.
|
|
||||||
|
|
||||||
Also, please read what is considered [commercial] use.
|
|
||||||
|
|
||||||
[commercial]: ../faq/sponsoring.md/#commercial-use
|
|
||||||
[non-commercial]: ../faq/sponsoring.md/#non-commercial-use
|
|
||||||
|
|
||||||
[__Why are one-time sponsorships not granted access to Insiders?__](#sponsorship-one-time){ #sponsorship-one-time }
|
|
||||||
|
|
||||||
Primarily due to technical reasons, that we're working on lifting in the future.
|
|
||||||
We use GitHub webhooks to determine our current active sponsors. When you create
|
|
||||||
or cancel your monthly subscription, GitHub sends events that we use to
|
|
||||||
automatically add and remove collaborators.
|
|
||||||
|
|
||||||
Note that [$15] is the minimum amount to be granted access to Insiders.
|
|
||||||
|
|
||||||
[$15]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638
|
|
||||||
|
|
||||||
[__How are sponsorship contributions used?__](#sponsorship-support){ #sponsorship-support }
|
|
||||||
|
|
||||||
It's vital to recognize that the total sponsorship amount doesn't directly
|
|
||||||
translate into the funds we have available for use. The way we allocate
|
|
||||||
sponsorship amounts is detailed as follows:
|
|
||||||
|
|
||||||
1. __Taxes__: Since we provide a service to our sponsors, we're of course
|
|
||||||
legally obligated to pay sales tax. This requirement applies to all
|
|
||||||
sponsorship contributions, aligning us with standard business practices
|
|
||||||
as for the rest of the world.
|
|
||||||
|
|
||||||
2. __Sponsorships__: A significant portion of our funding is redirected to
|
|
||||||
upstream projects. This cultivates collaboration and supports the broader
|
|
||||||
Open Source ecosystem. Those projects and their maintainers are essential
|
|
||||||
for the ongoing development of Material for MkDocs.
|
|
||||||
|
|
||||||
[Explore our sponsorships](https://github.com/squidfunk?tab=sponsoring).
|
|
||||||
|
|
||||||
3. __Funds__: We are in the process of forming a team devoted to Material for
|
|
||||||
MkDocs and are proactively compensating critical contributors. These
|
|
||||||
funds cover various aspects of the project, like the creation of new
|
|
||||||
features, bug resolution, support, and sponsor relations.
|
|
||||||
|
|
||||||
[__Are there any limitations on the number of sponsors for a particular tier?__](#sponsorship-limitations){ #sponsorship-limitations }
|
|
||||||
|
|
||||||
No, there are no limitations on the number of sponsors for any tier. You can
|
|
||||||
sponsor the project at any tier regardless of how many other sponsors are
|
|
||||||
already there.
|
|
||||||
|
|
||||||
## Payment & billing
|
|
||||||
|
|
||||||
[__Is there a trial period for the Insiders edition?__](#insiders-trial){ #insiders-trial }
|
|
||||||
|
|
||||||
No, we do not offer a trial period for the Insiders edition. However, if you're
|
|
||||||
a company and are considering sponsoring on the [commercial] tier, but want to
|
|
||||||
first give the Insiders edition a try, you can sponsor on the [$15] tier with a
|
|
||||||
personal account for [non-commercial] evaluation purposes.
|
|
||||||
|
|
||||||
Additionally, our subscription model allows you to cancel your sponsorship
|
|
||||||
anytime. If you decide to cancel, your sponsorship will remain active until
|
|
||||||
the end of your billing cycle.
|
|
||||||
|
|
||||||
[__What payment options do you accept?__](#insiders-payment){ #insiders-payment }
|
|
||||||
|
|
||||||
We manage all our transactions and sponsorships through [GitHub Sponsors]. To
|
|
||||||
become a sponsor of Material for MkDocs on GitHub, visit [our sponsors' page].
|
|
||||||
On there, you can choose from five different sponsorship tiers and pay by credit
|
|
||||||
card. Please note that as of the beginning of 2023,
|
|
||||||
[GitHub no longer supports PayPal] payments.
|
|
||||||
|
|
||||||
If you're a company and need assistance choosing the right payment method,
|
|
||||||
please don't hesitate to reach out to sponsors@squidfunk.com.
|
|
||||||
|
|
||||||
[GitHub Sponsors]: https://github.com/sponsors
|
|
||||||
[GitHub no longer supports PayPal]: https://github.blog/changelog/2023-01-23-github-sponsors-will-stop-supporting-paypal/
|
|
||||||
[our sponsors' page]: https://github.com/sponsors/squidfunk/
|
|
||||||
|
|
||||||
[__Are discounts available for the Insiders edition, such as student discounts?__](#insiders-discounts){ #insiders-discounts }
|
|
||||||
|
|
||||||
Unfortunately, we are not able to offer any discounts for the Material for
|
|
||||||
MkDocs Insiders program. To ensure that everyone can afford the Insiders program
|
|
||||||
and keep the barrier as low as possible, we have set prices as low as [$15] a
|
|
||||||
month for [non-commercial] use.
|
|
||||||
|
|
||||||
[__Do you offer free access to Insiders for Open Source projects?__](#insiders-open-source){ #insiders-open-source }
|
|
||||||
|
|
||||||
No, we do not offer free access to our Material for MkDocs Insiders edition.
|
|
||||||
We understand that non-profit organizations may have limited budgets and may
|
|
||||||
need to prioritize their spending on other projects or organizations. However,
|
|
||||||
it's important to note that Material for MkDocs is maintained by a small team,
|
|
||||||
investing a lot of time and resources into constantly improving this project.
|
|
||||||
Material for MkDocs and its core features are free to the community through our
|
|
||||||
Open Source model. Therefore, Material for MkDocs itself is already free.
|
|
||||||
|
|
||||||
However, we do offer an affordable sponsorship tier starting at [$15] a month,
|
|
||||||
which is meant for individuals and non-profit organizations using Material for
|
|
||||||
MkDocs to build 1-2 sites for [non-commercial] purposes. This tier provides access
|
|
||||||
to all new features, benefiting you from our ongoing development efforts.
|
|
||||||
|
|
||||||
[__Is Insiders free for those who contribute to this project?__](#insiders-contributors){ #insiders-contributors }
|
|
||||||
|
|
||||||
Thank you for your interest in contributing to Material for MkDocs! We value
|
|
||||||
every contribution, but it's important to distinguish between different types of
|
|
||||||
contributions. While minor edits such as typo corrections or adding new
|
|
||||||
languages are appreciated, they demand significant review efforts that exceed
|
|
||||||
the scope of such contributions. Consequently, free access to the Insiders
|
|
||||||
edition is exclusively offered to our [community experts].
|
|
||||||
|
|
||||||
If you're passionate about making a significant impact, we encourage you to
|
|
||||||
explore our [community experts] program. This program is designed for
|
|
||||||
experienced users eager to share their expertise on our [discussion board]. Our
|
|
||||||
discussion board facilitates the exchange of insights on workarounds, setups,
|
|
||||||
and features and addresses queries from users at all levels of experience. As a
|
|
||||||
community expert you become an integral part of our project by actively
|
|
||||||
assisting users and addressing their inquiries. This allows our team to focus
|
|
||||||
more on enhancing and developing new features – benefiting the entire community.
|
|
||||||
|
|
||||||
In acknowledgment of such valuable contributions, active [community experts] are
|
|
||||||
granted free access to the Insiders edition. This presents a fantastic
|
|
||||||
opportunity for you to make meaningful contributions while enjoying the perks of
|
|
||||||
the Insiders edition.
|
|
||||||
|
|
||||||
[community experts]: ../community-experts-program/index.md
|
|
||||||
|
|
||||||
[__Can I purchase the Insiders edition with a one-time donation?__](#one-time-donation){ #one-time-donation }
|
|
||||||
|
|
||||||
One-time donations, while appreciated, cannot support the ongoing development of
|
|
||||||
Material for MkDocs as subscriptions do. Our project's growth relies on steady
|
|
||||||
support from subscriptions to fund new features, updates, and maintenance.
|
|
||||||
Therefore, the Insiders version is not available through a one-time donation.
|
|
||||||
|
|
||||||
If monthly payments do not work for you or your company, you can adjust your
|
|
||||||
GitHub account's [billing cycle] to annual instead of monthly and sponsor at the
|
|
||||||
appropriate tier.
|
|
||||||
|
|
||||||
[billing cycle]: ../insiders/faq/sponsoring.md/#insiders-billing-cycle
|
|
||||||
|
|
||||||
[__How can I set my billing to monthly or yearly?__](#insiders-billing-cycle){ #insiders-billing-cycle }
|
|
||||||
|
|
||||||
Before you sponsor Material for MkDocs on one of our sponsoring tiers, you can
|
|
||||||
change your [billing cycle] to either monthly or yearly, according to your
|
|
||||||
preference. Your [billing cycle] is a setting at the account level on GitHub,
|
|
||||||
which you can easily modify in your account settings. When selecting one of our
|
|
||||||
sponsoring tiers, this adjustment will automatically categorize you as a monthly
|
|
||||||
or yearly sponsor.
|
|
||||||
|
|
||||||
If you find it challenging to make this change in your account, a practical
|
|
||||||
workaround is to create a dedicated GitHub bot account where you set the billing
|
|
||||||
cycle to yearly and use it specifically for your sponsorship contributions. This
|
|
||||||
is a strategy some of our sponsors have successfully implemented. For any
|
|
||||||
difficulties or further inquiries, please don’t hesitate to contact us at
|
|
||||||
sponsors@squidfunk.com for support.
|
|
||||||
|
|
||||||
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
|
|
||||||
|
|
||||||
[__Can I get an invoice for my sponsorship payment?__](#insiders-invoice){ #insiders-invoice}
|
|
||||||
|
|
||||||
Since [GitHub Sponsors] manages all transactions on our behalf, GitHub Sponsors
|
|
||||||
is considered your supplier, not us. As part of their process, GitHub Sponsors
|
|
||||||
automatically sends you a payment receipt via email for each billing cycle. It's
|
|
||||||
important to note that this document is a receipt, not an invoice. If you
|
|
||||||
require an invoice for your records, please contact us at sponsors@squidfunk.com
|
|
||||||
before initiating your sponsorship.
|
|
||||||
|
|
||||||
[GitHub Sponsors]: https://github.com/sponsors/squidfunk/
|
|
||||||
|
|
||||||
[__Can I switch between different sponsoring tiers?__](#insiders-switch-tiers){ #insiders-switch-tiers }
|
|
||||||
|
|
||||||
Yes, you can switch between different sponsoring tiers at any time. Simply go
|
|
||||||
to the [GitHub Sponsors] page and change your sponsoring tier. Once you make
|
|
||||||
that change, you will immediately change to the new tier.
|
|
||||||
|
|
||||||
If you change to a higher tier, the amount will be prorated according to your
|
|
||||||
billing cycle.
|
|
||||||
|
|
||||||
[__Can I sponsor the project for a specific feature or development goal?__](#insiders-goals){ #insiders-goals }
|
|
||||||
|
|
||||||
While sponsoring specific goals directly is not possible, our sponsoring goals
|
|
||||||
are connected to specific features or development goals aligned with the
|
|
||||||
project's roadmap. You can find an [overview of these sponsoring goals] and their
|
|
||||||
associated features on our website. Insider users have early access to all
|
|
||||||
already developed features, including those associated with higher funding goals
|
|
||||||
that will be reached at a later stage. If you're interested in accessing these
|
|
||||||
features, becoming a sponsor is the way to go. If you have a feature in mind
|
|
||||||
that you would like to see on the list, we encourage you to
|
|
||||||
[initiate a new discussion] to evaluate it with others.
|
|
||||||
|
|
||||||
[overview of these sponsoring goals]: ../index.md#goals
|
|
||||||
[initiate a new discussion]: https://github.com/squidfunk/mkdocs-material/discussions
|
|
||||||
|
|
||||||
[__What happens if I reach my sponsoring limit for my current tier?__](#insiders-limit){ #insiders-limit }
|
|
||||||
|
|
||||||
If you extend the number of sites that are in your current sponsoring limit,
|
|
||||||
please [upgrade your sponsorship] to a higher tier to continue using the
|
|
||||||
Insiders edition and build more sites. The change will be effective immediately.
|
|
||||||
|
|
||||||
[upgrade your sponsorship]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/upgrading-a-sponsorship
|
|
||||||
|
|
||||||
[__Do you offer refunds for sponsoring payments?__](#insiders-refunds){ #insiders-refunds }
|
|
||||||
|
|
||||||
Unfortunately, we cannot offer any refund for sponsorship payments.
|
|
||||||
[GitHub Sponsors] manages all sponsoring transactions. Because of that, we do
|
|
||||||
not have any insights into the details of the funds and cannot access them. If
|
|
||||||
you have any payment issues, please get in touch with the GitHub Sponsors
|
|
||||||
support team, as they can help you.
|
|
||||||
|
|
||||||
## Access management
|
|
||||||
|
|
||||||
[__How do I gain access to the private Insiders repository?__](#access-account){ #access-account }
|
|
||||||
|
|
||||||
If you sponsored with your __individual account__, you should have received an
|
|
||||||
email invitation to the private Material for MkDocs Insiders repository right
|
|
||||||
after you initiated your sponsorship. Simply accept the invitation within seven
|
|
||||||
days to gain access.
|
|
||||||
|
|
||||||
If you sponsored using an __organization account__, please note we need
|
|
||||||
an individual account that we can list as a collaborator of the private Insiders
|
|
||||||
repository. After you initiate your sponsorship, please email us at
|
|
||||||
sponsors@squidfunk.com with the name of the individual or bot account. Once you
|
|
||||||
provide us with this information, we will add the account as a collaborator, and
|
|
||||||
after you accept the invitation, you will gain access to the repository.
|
|
||||||
|
|
||||||
If you have yet to receive the email or the invitation link has expired, please
|
|
||||||
contact us, the maintainers, at sponsors@squidfunk.com. We're working on a
|
|
||||||
solution that will allow you to manage collaborator status yourself.
|
|
||||||
|
|
||||||
[__Why can't our whole organization get access to Insiders?__](#access-organization){ #access-organization }
|
|
||||||
|
|
||||||
Currently, it is not possible to grant access to an organizational account, as
|
|
||||||
GitHub only allows for adding individual user accounts. We are working on a
|
|
||||||
solution ourselves to simplify access for organizations. For now, to ensure that
|
|
||||||
access is not tied to a particular individual, we recommend creating a bot
|
|
||||||
account, i.e., a GitHub account that does not belong to a specific individual
|
|
||||||
but is listed as the owner of the organizational account and using this account
|
|
||||||
for sponsorship.
|
|
||||||
|
|
||||||
[__Do I need to fork the repository to use it?__](#access-fork){ #access-fork }
|
|
||||||
|
|
||||||
It depends. If you are using the Insiders edition as an individual, you can work
|
|
||||||
directly with the private repository, as you do not need to share the Insiders
|
|
||||||
features with others. If you are working with a team, it is best to create a
|
|
||||||
private [fork] using the individual account you listed as a collaborator of
|
|
||||||
Material for MkDocs to grant access to all members of your organization to
|
|
||||||
your fork.
|
|
||||||
|
|
||||||
[__Can I share my Insiders access with others?__](#access-share){ #access-share }
|
|
||||||
|
|
||||||
At the moment, it is not possible to directly share your collaborator status
|
|
||||||
for the private Insiders repository with other accounts. However, if you are
|
|
||||||
working with a team and would like them to access Insiders, you can share the
|
|
||||||
Insiders repository by utilizing options such as [cloning], [forking], or
|
|
||||||
[mirroring]. By doing so, you can start collaborating with your team members on
|
|
||||||
the new repository you have shared. This way, you can collectively benefit
|
|
||||||
from the Insiders features and work together on the project.
|
|
||||||
|
|
||||||
[cloning]: https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository
|
|
||||||
[forking]: https://docs.github.com/en/get-started/quickstart/fork-a-repo
|
|
||||||
[mirroring]: https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository
|
|
||||||
|
|
||||||
|
|
||||||
## Runtime & cancellation
|
|
||||||
|
|
||||||
[__How long is my sponsorship valid?__](#sponsorship-runtime){ #sponsorship-runtime }
|
|
||||||
|
|
||||||
Your sponsorship is valid for as long as your monthly or yearly subscription
|
|
||||||
is valid. If you choose to cancel your sponsorship, you will lose access to
|
|
||||||
the Insiders edition once your cancellation is active and will be automatically
|
|
||||||
removed by GitHub as a collaborator from the private repository.
|
|
||||||
|
|
||||||
[__How do I cancel my sponsorship?__](#sponsorship-cancellation){ #sponsorship-cancellation }
|
|
||||||
|
|
||||||
To cancel your sponsorship, follow the [step-by-step guide] provided by GitHub.
|
|
||||||
If you sponsored using an organizational account, please ensure that you cancel
|
|
||||||
your sponsorship using the same organizational account rather than your
|
|
||||||
individual account.
|
|
||||||
|
|
||||||
[step-by-step guide]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/downgrading-a-sponsorship
|
|
||||||
|
|
||||||
[__What happens when I cancel my sponsorship?__](#sponsorship-cancellation-effective){ #sponsorship-cancellation-effective }
|
|
||||||
|
|
||||||
If you choose to cancel your subscription to Insiders, you will be
|
|
||||||
automatically removed by GitHub as a collaborator on the day your cancellation is
|
|
||||||
effective. From that day on, you will no longer receive future updates. However,
|
|
||||||
you are __welcome to continue using the latest version__ that was available to
|
|
||||||
you at the time of your cancellation for as long as you like.
|
|
||||||
|
|
||||||
Please note that [GitHub deletes private forks], so you may want to take steps
|
|
||||||
to ensure that you have a backup of the software if necessary and use the
|
|
||||||
locally installed version.
|
|
||||||
|
|
||||||
[GitHub deletes private forks]: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository#deleting-forks-of-private-repositories
|
|
||||||
|
|
||||||
## Licensing
|
|
||||||
|
|
||||||
[__What constitutes commercial use of the Insiders edition?__](#commercial-use){ #commercial-use }
|
|
||||||
|
|
||||||
Commercial use refers to any use of the software for a business or for-profit
|
|
||||||
purpose. This includes any use by a corporation or other organization, whether
|
|
||||||
or not they generate revenue directly from the software. We offer different
|
|
||||||
pricing tiers for commercial use, each tailored to the needs of different
|
|
||||||
businesses. It's important to note that internal use of the software within your
|
|
||||||
organization is also considered commercial use, as with all commercial software.
|
|
||||||
|
|
||||||
[__What constitutes non-commercial use of the Insiders edition?__](#non-commercial-use){ #non-commercial-use }
|
|
||||||
|
|
||||||
[Non-commercial] use of our Material for MkDocs refers to private use. This
|
|
||||||
includes individuals using the Insiders edition for private or purely
|
|
||||||
non-commercial Open Source projects. We offer two different tiers for
|
|
||||||
non-commercial use, depending on the number of sites you want to build.
|
|
||||||
|
|
||||||
[__What is your fair use policy?__](#fair-use-policy){ #fair-use-policy }
|
|
||||||
|
|
||||||
Our fair use policy includes the following guidelines:
|
|
||||||
|
|
||||||
- Please refrain from __distributing the source code__ of Insiders. While you
|
|
||||||
may use the software for public, private, or commercial projects and may
|
|
||||||
privately [fork] or [mirror] it, we ask that you keep the source code private. This
|
|
||||||
is important to our sponsorware strategy, which helps us fund ongoing
|
|
||||||
development and support of the software. If this guidelines is violated,
|
|
||||||
everybody loses, as it will reduce the time of us maintainers we can set aside
|
|
||||||
to push this project forward.
|
|
||||||
|
|
||||||
- As our sponsoring tiers are based on the number of sites you want to build,
|
|
||||||
please make sure to [upgrade your sponsorship] once your current sponsoring tier
|
|
||||||
limit has been reached.
|
|
||||||
|
|
||||||
[__Does the Insiders edition have a different license?__](#insiders-license){ #insiders-license }
|
|
||||||
|
|
||||||
No. 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].
|
|
||||||
|
|
||||||
[MIT license]: ../../license.md
|
|
||||||
|
|
||||||
[__Can outside collaborators build and run the documentation locally without access to Insiders?__](#insiders-outside-collaborators){ #insiders-outside-collaborators }
|
|
||||||
|
|
||||||
Yes. Insiders is compatible with Material for MkDocs. Almost all new features
|
|
||||||
and configuration options are either backward-compatible or implemented behind
|
|
||||||
feature flags. When working with outside collaborators, changing the general
|
|
||||||
appearance of your site should be optional. Most Insiders features enhance the
|
|
||||||
overall experience, e.g., by adding icons to pages or providing a feedback
|
|
||||||
widget. While these features add value for your site's users, they should be
|
|
||||||
optional for previewing when making changes to content. Currently, the only
|
|
||||||
content-related feature in Insiders that non-Insiders users can't properly
|
|
||||||
preview are [Card grids].
|
|
||||||
|
|
||||||
This means that outside collaborators can build the documentation locally with
|
|
||||||
Material for MkDocs, and when they push their changes, your CI pipeline will
|
|
||||||
build it with Insiders. When using built-in plugins exclusive to Insiders, it's
|
|
||||||
recommended to split configuration into a base `mkdocs.yml` and one with plugin
|
|
||||||
overrides via [configuration inheritance].
|
|
||||||
|
|
||||||
See the [getting started guide] for more information.
|
|
||||||
|
|
||||||
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
|
||||||
[getting started guide]: ../getting-started.md
|
|
||||||
[Card grids]: ../../reference/grids.md?h=grids#using-card-grids
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
[__How can I contact support if I have questions about becoming a sponsor?__ ](#support-contact){ #support-contact }
|
|
||||||
|
|
||||||
If you have any questions and would like to contact us before starting your
|
|
||||||
sponsorship, we are happy to answer all your non-technical questions about the
|
|
||||||
Insiders program via email at sponsors@squidfunk.com.
|
|
||||||
|
|
||||||
All technical questions should be asked openly on our [discussion board].
|
|
||||||
|
|
||||||
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
|
|
||||||
|
|
||||||
[__Is additional support available for Material for MkDocs Insiders users?__](#support-additional){ #support-additional }
|
|
||||||
|
|
||||||
Yes, we provide non-technical support related to sponsoring at
|
|
||||||
sponsors@squidfunk.com. For technical questions, please submit an issue openly
|
|
||||||
on our [issue tracker] or start a discussion on our [discussion board]. Issues
|
|
||||||
and discussions from our organizational sponsors, sponsoring on
|
|
||||||
__The Organization__ tier or higher will be prioritized.[^1]
|
|
||||||
|
|
||||||
[^1]:
|
|
||||||
Priority support means we will prioritize your issue, meaning we will look
|
|
||||||
into it and do our best to solve your issue asap. However, the prioritized bug
|
|
||||||
support does not mean that we can solve your issue before any others since
|
|
||||||
some issues might take more time to solve.
|
|
||||||
|
|
||||||
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
|
|
||||||
|
|
||||||
[__How can I display my logo on the list of premium sponsors?__](#sponsorship-logo-placement){ #sponsorship-logo-placement }
|
|
||||||
|
|
||||||
If your sponsorship tier includes logo placement, and you would like us to
|
|
||||||
display your logo in the [list of premium sponsors] and have it linked to your
|
|
||||||
site, please contact us via mail. Simply send us a horizontal SVG or PNG version
|
|
||||||
of your logo making sure it displays the name of your company and the logo to
|
|
||||||
sponsors@squidfunk.com.
|
|
||||||
|
|
||||||
[list of premium sponsors]: https://github.com/squidfunk/mkdocs-material#user-content-premium-sponsors
|
|
||||||
|
|
||||||
[__Is logo placement optional?__](#sponsorship-logo-placement-optional){ #sponsorship-logo-placement-optional }
|
|
||||||
|
|
||||||
Yes, all of our commercial benefits, such as logo placement and backlinks, are
|
|
||||||
optional and can be opted in or out at any time. You can keep your sponsorship
|
|
||||||
completely private.
|
|
||||||
|
|
||||||
[__How can I report a bug in the Insiders edition?__](#insiders-bugs){ #insiders-bugs }
|
|
||||||
|
|
||||||
If you encounter a bug in the Insiders edition, we kindly request that you
|
|
||||||
report it on our [issue tracker] in the public community repository. When
|
|
||||||
submitting the bug report, please ensure that you do not include any private
|
|
||||||
Insiders' source code, as we want to uphold our fair use policy.
|
|
||||||
|
|
||||||
[__How can I report an issue in my customizations?__](#customizations-issues){ #customizations-issues }
|
|
||||||
|
|
||||||
Please note, that we do not offer support for customizations as they vary
|
|
||||||
widely and are specific to individual cases. Our support is primarily focused on
|
|
||||||
assisting with our core features. When reporting an issue, please remove all
|
|
||||||
customizations to ensure effective problem diagnosis with a minimal reproduction
|
|
||||||
[.zip file], as described in our bug reporting guide. Our [built-in info plugin],
|
|
||||||
which is essential when creating a reproduction, will not function correctly
|
|
||||||
with customizations in place. For questions and issues with customizations,
|
|
||||||
please use our [discussion board] to engage with the community.
|
|
||||||
|
|
||||||
[.zip file]: ../../guides/creating-a-reproduction.md
|
|
||||||
[built-in info plugin]: https://squidfunk.github.io/mkdocs-material/guides/creating-a-reproduction/#creating-a-zip-file
|
|
||||||
|
|
||||||
## Privacy
|
|
||||||
|
|
||||||
[__Will you sign an NDA for sponsorships?__](#nda){ #nda }
|
|
||||||
|
|
||||||
Unfortunately, we cannot sign any NDA or vendor agreement form. As a small team
|
|
||||||
working on Material for MkDocs, we have limited resources and cannot review
|
|
||||||
and sign agreements.
|
|
||||||
|
|
||||||
[__Will you fill out our companys forms?__](#forms){ #forms }
|
|
||||||
|
|
||||||
To dedicate more time and resources to the development of our projects, we have
|
|
||||||
implemented measures to minimize administrative overhead for our small team. As
|
|
||||||
part of this approach, we have adopted GitHub Sponsors to efficiently handle all
|
|
||||||
transactions for us. Consequently, we have decided to introduce a setup fee for
|
|
||||||
any additional administrative tasks other than those handled by GitHub Sponsors
|
|
||||||
that require our attention and involve the completion of forms or adherence to
|
|
||||||
company processes when purchasing Material for MkDocs Insiders. If your purchase
|
|
||||||
department requires additional time and effort from our team, please be aware
|
|
||||||
that the setup fee will apply. For detailed information and specific inquiries,
|
|
||||||
please reach out to us at sponsors@squidfunk.com.
|
|
||||||
|
|
||||||
[__Can I sponsor privately?__](#sponsorship-private){ #sponsorship-private }
|
|
||||||
|
|
||||||
Yes, you can. GitHub offers the option to [set your sponsorship to private] when
|
|
||||||
you initiate your sponsorship. This means that your account will not appear in
|
|
||||||
sponsor-listings so there is no public affiliation with Material for MkDocs.
|
|
||||||
Only we know that you sponsored, but we will never disclose this information
|
|
||||||
without your written consent.
|
|
||||||
|
|
||||||
[set your sponsorship to private]: https://docs.github.com/en/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship#managing-the-privacy-setting-for-your-sponsorship
|
|
||||||
[fork]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
|
|
||||||
[mirror]: https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository
|
|
||||||
|
|
||||||
[__Are there any geographical restrictions on becoming a sponsor?__](#sponsorship-geo){ #sponsorship-geo }
|
|
||||||
|
|
||||||
No, there are no geographical restrictions for becoming a sponsor. We welcome
|
|
||||||
sponsorships from individuals and organizations worldwide. As long as your
|
|
||||||
credit card is valid and accepted by GitHub you are eligible to become
|
|
||||||
a sponsor and support the project, regardless of your location.
|
|
114
docs/insiders/how-to-sponsor.md
Normal file
114
docs/insiders/how-to-sponsor.md
Normal file
@ -0,0 +1,114 @@
|
|||||||
|
# How to sponsor
|
||||||
|
|
||||||
|
Becoming a sponsor for Material for MkDocs is a straightforward process through
|
||||||
|
@squidfunk's [GitHub Sponsors profile]. By supporting
|
||||||
|
the project with a monthly contribution of __$15 a month__ or more, you can sponsor
|
||||||
|
either via an [individual] or [organizational] GitHub account.
|
||||||
|
|
||||||
|
[GitHub Sponsors profile]: https://github.com/sponsors/squidfunk
|
||||||
|
[individual]: access-management.md/#individuals
|
||||||
|
[organizational]: access-management.md/#organizations
|
||||||
|
|
||||||
|
## Walkthrough
|
||||||
|
|
||||||
|
Want to become a sponsor? We will guide you through the sponsoring process below
|
||||||
|
If you have additional questions, you can find detailed information about
|
||||||
|
[payment and billing], [access management], [runtime and cancellation],
|
||||||
|
[privacy], [license] and [support] on dedicated pages.
|
||||||
|
|
||||||
|
[payment and billing]: payment-and-billing.md
|
||||||
|
[access management]: access-management.md
|
||||||
|
[runtime and cancellation]: runtime-and-cancellation.md
|
||||||
|
[privacy]: privacy.md
|
||||||
|
[license]: license.md
|
||||||
|
[support]: ../support.md
|
||||||
|
|
||||||
|
### Sponsoring tier
|
||||||
|
|
||||||
|
First, it's a good idea to explore [our sponsoring tiers], as each sponsoring
|
||||||
|
tier is designed to accommodate different levels of sponsors and includes
|
||||||
|
dedicated benefits.
|
||||||
|
|
||||||
|
After reviewing the sponsoring tiers, it's time to choose one. Consider what you
|
||||||
|
want to achieve and keep your requirements in mind, e.g. the number of projects
|
||||||
|
you want to build or how many accounts you need. [Switching tiers] is possible
|
||||||
|
at any time.
|
||||||
|
|
||||||
|
Choosing a tier will take you to GitHub's sponsorship confirmation page.
|
||||||
|
|
||||||
|
[our sponsoring tiers]: sponsoring-tiers.md
|
||||||
|
[Switching tiers]: sponsoring-tiers.md/#switching-tiers
|
||||||
|
|
||||||
|
### Sponsorship summary
|
||||||
|
|
||||||
|
#### Payment and billing
|
||||||
|
|
||||||
|
Next, GitHub will ask you to provide your billing information, which is required
|
||||||
|
to process your sponsorship payment. On this page, the _Sponsorship summary_
|
||||||
|
section displays the (possibly prorated) amount due to initiate your sponsorship.
|
||||||
|
This amount is determined by your account's [billing cycle], which can be set to
|
||||||
|
a monthly or yearly interval.
|
||||||
|
|
||||||
|
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
|
||||||
|
|
||||||
|
Proceed to input your [payment information], specifically your credit card
|
||||||
|
details. Please make sure that the used credit card is valid and will remain
|
||||||
|
so for an extended period to help avoid any interruptions in your sponsorship.
|
||||||
|
|
||||||
|
[payment information]: payment-and-billing.md
|
||||||
|
|
||||||
|
#### Privacy
|
||||||
|
|
||||||
|
On this page, you can also set the visibility of your sponsorship. You have the
|
||||||
|
option to keep your [sponsorship private or to make it public], which includes
|
||||||
|
listing your name or organization on the list of [our sponsors] and, for
|
||||||
|
organizations, the opportunity for [logo placement].
|
||||||
|
|
||||||
|
[sponsorship private or to make it public]: privacy.md
|
||||||
|
[our sponsors]: our-sponsors.md
|
||||||
|
[logo placement]: our-sponsors.md/#our-premium-sponsors
|
||||||
|
|
||||||
|
#### News and updates
|
||||||
|
|
||||||
|
Note that we rarely send out emails, and when we do, it's usually to inform you
|
||||||
|
about significant updates or changes to the project, so it's best to keep this
|
||||||
|
option enabled. To stay updated on the latest developments, you can check out
|
||||||
|
our [changelog].
|
||||||
|
|
||||||
|
[changelog]: ../changelog/index.md
|
||||||
|
|
||||||
|
#### Tax information
|
||||||
|
|
||||||
|
If you're sponsoring as an organization, it's essential to provide your country,
|
||||||
|
region and VAT number, so we can correctly attribute your sponsorship. This is
|
||||||
|
due to the fact that VAT is handled differently for individuals than for
|
||||||
|
organizations.
|
||||||
|
|
||||||
|
#### Confirmation
|
||||||
|
|
||||||
|
Before finalizing your sponsorship, take a moment to review all the details of
|
||||||
|
your sponsorship, including the selected tier, billing information, and payment
|
||||||
|
details.
|
||||||
|
|
||||||
|
Then proceed to confirm your sponsorship by clicking the _Sponsor_ button.
|
||||||
|
|
||||||
|
### Access management
|
||||||
|
|
||||||
|
After completing the sponsorship process and your payment is successfully
|
||||||
|
processed, you will be all set to [gain access] to the private Material for
|
||||||
|
MkDocs Insiders repository.
|
||||||
|
|
||||||
|
[gain access]: access-management.md
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
__Ready to become a sponsor?__
|
||||||
|
|
||||||
|
[ Choose a sponsoring tier <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][sponsoring-tiers]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[sponsoring-tiers]: sponsoring-tiers.md
|
||||||
|
|
||||||
|
If you still find yourself with more questions, feel free to [reach out to Kathi]
|
||||||
|
via mail at sponsors@squidfunk.com for additional support.
|
||||||
|
|
||||||
|
[reach out to Kathi]: ../support.md/#sponsoring-support
|
@ -1,595 +1,233 @@
|
|||||||
---
|
|
||||||
title: Insiders
|
|
||||||
---
|
|
||||||
|
|
||||||
# Insiders
|
# Insiders
|
||||||
|
|
||||||
Material for MkDocs follows the __sponsorware__ release strategy, which means
|
If you want to get the best out of Material for MkDocs, Insiders is what you're
|
||||||
that new features are first exclusively released to sponsors as part of
|
looking for – it's an exclusive version of Material for MkDocs that offers
|
||||||
[Insiders]. Read on to learn [what sponsorships achieve],
|
additional features and enhancements. By becoming a sponsor, you get early access
|
||||||
[how to become a sponsor] to get access to Insiders, and [what's in it for you]!
|
|
||||||
|
|
||||||
<!-- <figure class="mdx-video" markdown>
|
Material for MkDocs Insiders offers an enhanced experience with early access to
|
||||||
<div class="mdx-video__inner">
|
exclusive features that aren't available in the community edition. Become a
|
||||||
<iframe src="https://streamable.com/e/yslhdu" allowfullscreen></iframe>
|
sponsor and make use of these features directly!
|
||||||
</div>
|
|
||||||
<figcaption markdown>
|
|
||||||
|
|
||||||
This documentation is built with Insiders
|
You’ve already seen the benefits of using Material for MkDocs;
|
||||||
[squidfunk.github.io/mkdocs-material][Material for MkDocs]
|
imagine what more you can achieve with Insiders. Your sponsorship helps us
|
||||||
|
continue to innovate and improve, ensuring Material for MkDocs remains a
|
||||||
|
cutting-edge tool. Discover how your contributions make a difference.
|
||||||
|
|
||||||
</figcaption>
|
[ Choose a sponsoring tier <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][sponsoring-tiers]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
</figure> -->
|
|
||||||
|
|
||||||
[Insiders]: #what-is-insiders
|
[sponsoring-tiers]: sponsoring-tiers.md
|
||||||
[what sponsorships achieve]: #what-sponsorships-achieve
|
|
||||||
[how to become a sponsor]: #how-to-become-a-sponsor
|
|
||||||
[what's in it for you]: #whats-in-it-for-me
|
|
||||||
[Material for MkDocs]: https://squidfunk.github.io/mkdocs-material/
|
|
||||||
|
|
||||||
## What is Insiders?
|
## Additional information
|
||||||
|
|
||||||
Material for MkDocs Insiders is a private fork of Material for MkDocs, hosted as
|
Explore the following section to learn more about Material for MkDocs, why
|
||||||
a private GitHub repository. Almost[^1] [all new features][what's in it for you]
|
you should sponsor us, what's in it for you, and who is sponsoring us.
|
||||||
are developed as part of this fork, which means that they are immediately
|
|
||||||
available to all eligible sponsors, as they are made collaborators of this
|
|
||||||
repository.
|
|
||||||
|
|
||||||
[^1]:
|
<div class="grid cards" markdown>
|
||||||
In general, every new feature is first exclusively released to sponsors, but
|
|
||||||
sometimes upstream dependencies like [Python Markdown Extensions] enhance
|
|
||||||
existing features that must be supported by Material for MkDocs.
|
|
||||||
|
|
||||||
Every feature is tied to a [funding goal] in monthly subscriptions. When a
|
- :fontawesome-solid-circle-question:
|
||||||
funding goal is hit, the features that are tied to it are merged back into
|
__Why sponsor us__
|
||||||
Material for MkDocs and released for general availability, making them available
|
|
||||||
to all users. Bugfixes are always released in tandem.
|
|
||||||
|
|
||||||
Sponsorships start as low as [__$15 a month__][how to become a sponsor].[^2]
|
---
|
||||||
|
|
||||||
[^2]:
|
Learn how to support our goal of becoming the leading tool in documentation
|
||||||
Note that $15 a month is the minimum amount to become eligible for
|
|
||||||
Insiders. While GitHub Sponsors also allows to sponsor lower amounts or
|
|
||||||
one-time amounts, those can't be granted access to Insiders due to
|
|
||||||
technical reasons.
|
|
||||||
|
|
||||||
[Python Markdown Extensions]: https://facelessuser.github.io/pymdown-extensions/
|
---
|
||||||
[funding goal]: #funding
|
|
||||||
|
|
||||||
## What sponsorships achieve
|
[:octicons-arrow-right-24: More information][Why sponsor us]
|
||||||
|
|
||||||
Sponsorships make this project sustainable, as they buy the maintainers of this
|
- :material-gift:
|
||||||
project time – a very scarce resource – which is spent on the development of new
|
__What's in it for you__
|
||||||
features, bug fixing, stability improvement, issue triage and general support.
|
|
||||||
The biggest bottleneck in Open Source is time.[^3]
|
|
||||||
|
|
||||||
[^3]:
|
---
|
||||||
Making an Open Source project sustainable is exceptionally hard: maintainers
|
|
||||||
burn out, projects are abandoned. That's not great and very unpredictable.
|
|
||||||
The sponsorware model ensures that if you decide to use Material for MkDocs,
|
|
||||||
you can be sure that bugs are fixed quickly and new features are added
|
|
||||||
regularly.
|
|
||||||
|
|
||||||
If you're unsure if you should sponsor this project, check out the list of
|
Discover exclusive benefits and features available only to our monthly sponsors
|
||||||
[completed funding goals] to learn whether you're already using features that
|
|
||||||
were developed with the help of sponsorships. You're most likely using at least
|
|
||||||
a handful of them, [thanks to our awesome sponsors]!
|
|
||||||
|
|
||||||
[completed funding goals]: #goals-completed
|
---
|
||||||
[thanks to our awesome sponsors]: #how-to-become-a-sponsor
|
|
||||||
|
|
||||||
<figure style="min-width:15.6rem">
|
[:octicons-arrow-right-24: More infomation][What's in it for you]
|
||||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true">
|
|
||||||
<a href="https://twitter.com/WillingCarol/status/1603416470616088576?ref_src=twsrc%5Etfw"></a>
|
|
||||||
</blockquote>
|
|
||||||
<script async src="https://platform.twitter.com/widgets.js"></script>
|
|
||||||
</figure>
|
|
||||||
|
|
||||||
## What's in it for me?
|
- :fontawesome-solid-people-group:
|
||||||
|
__Who is sponsoring__
|
||||||
|
|
||||||
The moment you [become a sponsor][how to become a sponsor], you'll get __immediate
|
---
|
||||||
access to 26 additional features__ that you can __start using now__, and
|
|
||||||
which are currently exclusively available to sponsors:
|
|
||||||
|
|
||||||
<div class="mdx-columns" markdown>
|
Get to know our awesome sponsors, financially backing Material for MkDocs
|
||||||
|
|
||||||
- [x] [Blog plugin: pinned posts] :material-alert-decagram:{ .mdx-pulse title="Added on February 24, 2024" }
|
---
|
||||||
- [x] [Instant previews] :material-alert-decagram:{ .mdx-pulse title="Added on January 28, 2024" }
|
|
||||||
- [x] [Footnote tooltips] :material-alert-decagram:{ .mdx-pulse title="Added on January 24, 2024" }
|
[:octicons-arrow-right-24: More infomation][Who is sponsoring]
|
||||||
- [x] [Tags plugin: advanced settings]
|
|
||||||
- [x] [Tags plugin: nested tags]
|
|
||||||
- [x] [Tags plugin: shadow tags]
|
|
||||||
- [x] [Stay on page when switching languages]
|
|
||||||
- [x] [Blog plugin: author profiles]
|
|
||||||
- [x] [Blog plugin: advanced settings]
|
|
||||||
- [x] [Projects plugin]
|
|
||||||
- [x] [Instant prefetching]
|
|
||||||
- [x] [Social plugin: custom layouts]
|
|
||||||
- [x] [Social plugin: background images]
|
|
||||||
- [x] [Code range selection]
|
|
||||||
- [x] [Code annotations: custom selectors]
|
|
||||||
- [x] [Privacy plugin: advanced settings]
|
|
||||||
- [x] [Optimize plugin]
|
|
||||||
- [x] [Navigation path] (Breadcrumbs)
|
|
||||||
- [x] [Typeset plugin]
|
|
||||||
- [x] [Privacy plugin: external links]
|
|
||||||
- [x] [Navigation subtitles]
|
|
||||||
- [x] [Tags plugin: allow list] + [custom sorting]
|
|
||||||
- [x] [Blog plugin: custom index pages]
|
|
||||||
- [x] [Blog plugin: related links]
|
|
||||||
- [x] [Meta plugin]
|
|
||||||
- [x] [Tags plugin: configurable listings]
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
New features are added every other week. Be sure to come back.
|
### Sponsoring guide
|
||||||
|
|
||||||
## How to become a sponsor
|
Learn how to become a sponsor of Material for MkDocs Insiders and start your
|
||||||
|
sponsorship journey by choosing the right tier for you:
|
||||||
|
|
||||||
Thanks for your interest in sponsoring! In order to become an eligible sponsor
|
<div class="grid cards" markdown>
|
||||||
with your GitHub account, visit [squidfunk's sponsor profile], and complete
|
|
||||||
a sponsorship of __$15 a month or more__. You can use your individual or
|
|
||||||
organization GitHub account for sponsoring.
|
|
||||||
|
|
||||||
__Important__: If you're sponsoring @squidfunk through a GitHub organization,
|
|
||||||
please send a short email to sponsors@squidfunk.com with the name of your
|
|
||||||
organization and the GitHub account of the individual that should be added as a
|
|
||||||
collaborator.[^4]
|
|
||||||
|
|
||||||
You can cancel your sponsorship anytime.[^5]
|
- :material-animation-outline:
|
||||||
|
__Sponsoring tiers__
|
||||||
|
|
||||||
[^4]:
|
---
|
||||||
It's currently not possible to grant access to each member of an
|
|
||||||
organization, as GitHub only allows for adding users. Thus, after
|
|
||||||
sponsoring, please send an email to sponsors@squidfunk.com, stating which
|
|
||||||
account should become a collaborator of the Insiders repository. We're
|
|
||||||
working on a solution which will make access to organizations much simpler.
|
|
||||||
To ensure that access is not tied to a particular individual GitHub account,
|
|
||||||
create a bot account (i.e. a GitHub account that is not tied to a specific
|
|
||||||
individual), and use this account for the sponsoring. After being added to
|
|
||||||
the list of collaborators, the bot account can create a private fork of the
|
|
||||||
private Insiders GitHub repository, and grant access to all members of the
|
|
||||||
organizations.
|
|
||||||
|
|
||||||
[^5]:
|
Find the perfect monthly sponsoring tier that fits your needs and
|
||||||
If you cancel your sponsorship, GitHub schedules a cancellation request
|
requirements
|
||||||
which will become effective at the end of the billing cycle. This means
|
|
||||||
that even though you cancel your sponsorship, you will keep your access to
|
|
||||||
Insiders as long as your cancellation isn't effective. All charges are
|
|
||||||
processed by GitHub through Stripe. As we don't receive any information
|
|
||||||
regarding your payment, and GitHub doesn't offer refunds, sponsorships are
|
|
||||||
non-refundable.
|
|
||||||
|
|
||||||
[:octicons-heart-fill-24:{ .mdx-heart } Join our <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span> awesome sponsors][squidfunk's sponsor profile]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
---
|
||||||
|
|
||||||
<hr />
|
[:octicons-arrow-right-24: More information][Sponsoring tiers]
|
||||||
|
|
||||||
<div class="mdx-premium" markdown>
|
- :octicons-heart-fill-24:{ .mdx-heart }
|
||||||
|
__How to sponsor__
|
||||||
|
|
||||||
**Silver sponsors**:
|
---
|
||||||
|
|
||||||
[![FastAPI]{ style="height: 120px" }](https://fastapi.tiangolo.com/){ target=_blank title="FastAPI" }
|
Follow our step-by-step guide on how to become a sponsor to get you started
|
||||||
[![Trendpop]{ style="height: 120px" }](https://www.trendpop.com/){ target=_blank title="Trendpop" }
|
|
||||||
[![SailPoint]{ style="height: 120px" }](https://documentation.sailpoint.com/){ target=_blank title="SailPoint" }
|
|
||||||
|
|
||||||
**Bronze sponsors**:
|
---
|
||||||
|
|
||||||
[![Cirrus CI]](https://cirrus-ci.org/){ target=_blank title="Cirrus CI" }
|
[:octicons-arrow-right-24: More information][How to sponsor]
|
||||||
[![Basler]](https://docs.baslerweb.com/){ target=_blank title="Basler" }
|
|
||||||
[![KX]](https://kx.com/){ target=_blank title="KX Systems" }
|
|
||||||
[![Prefect]](https://orion-docs.prefect.io/){ target=_blank title="Prefect" }
|
|
||||||
[![Zenoss]](https://zenoss.com/){ target=_blank title="Zenoss" }
|
|
||||||
[![Posit]](https://docs.posit.co){ target=_blank title="Posit" }
|
|
||||||
[![n8n]](https://n8n.io){ target=_blank title="n8n" }
|
|
||||||
[![Dogado]](https://www.dogado.de){ target=_blank title="Dogado" }
|
|
||||||
[![World Wide Technology]](https://wwt.com){ target=_blank title="World Wide Technology" }
|
|
||||||
[![Coda]](https://coda.io){ target=_blank title="Coda" }
|
|
||||||
[![Elastic]](https://elastic.co){ target=_blank title="Elastic" }
|
|
||||||
[![IP Fabric]](https://ipfabric.io/){ target=_blank title="IP Fabric" }
|
|
||||||
[![Apex.AI]](https://www.apex.ai/){ target=_blank title="Apex.AI" }
|
|
||||||
[![Jitterbit]](https://jitterbit.com/){ target=_blank title="Jitterbit" }
|
|
||||||
[![Sparkfun]](https://sparkfun.com/){ target=_blank title="Sparkfun Electronics" }
|
|
||||||
[![Eccenca]](https://eccenca.com/){ target=_blank title="Eccenca" }
|
|
||||||
[![Neptune]](https://neptune.ai/){ target=_blank title="Neptune" }
|
|
||||||
[![RackN]](https://rackn.com/){ target=_blank title="RackN" }
|
|
||||||
[![CivicActions]](https://civicactions.com/){ target=_blank title="CivicActions" }
|
|
||||||
[![bitcrowd]](https://bitcrowd.net/){ target=_blank title="bitcrowd" }
|
|
||||||
[![GetScreen.me]](https://getscreen.me/){ target=_blank title="GetScreen.me" }
|
|
||||||
[![BotCity]](https://botcity.dev/){ target=_blank title="BotCity" }
|
|
||||||
[![Springer Nature Technology]](https://www.springernature.com/gp){ target=_blank title="Springer Nature Technology" }
|
|
||||||
[![Kolena]](https://kolena.io/){ target=_blank title="Kolena" }
|
|
||||||
[![Evergiving]](https://www.evergiving.com/){ target=_blank title="Evergiving" }
|
|
||||||
[![Koor]](https://koor.tech/){ target=_blank title="Koor" }
|
|
||||||
[![Astral]](https://astral.sh/){ target=_blank title="Astral" }
|
|
||||||
[![Oikolab]](https://oikolab.com/){ target=_blank title="Oikolab" }
|
|
||||||
[![Bühler Group]](https://www.buhlergroup.com/){ target=_blank title="Bühler Group" }
|
|
||||||
[![Transformation Flow]](https://transformationflow.io/){ target=_blank title="Transformation Flow" }
|
|
||||||
[![3DR]](https://3dr.com/){ target=_blank title="3DR" }
|
|
||||||
[![Spotware]](https://spotware.com/){ target=_blank title="Spotware" }
|
|
||||||
[![Milford Assets]](https://milfordasset.com/){ target=_blank title="Milford Assets" }
|
|
||||||
[![Lechler]](https://www.lechler.com/){ target=_blank title="Lechler" }
|
|
||||||
[![Invers]](https://invers.com/){ target=_blank title="Invers" }
|
|
||||||
[![Maxar]](https://maxar.com/){ target=_blank title="Maxar" }
|
|
||||||
[![EquipmentShare]](https://www.equipmentshare.com/){ target=_blank title="EquipmentShare" }
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
[FastAPI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-fastapi.png
|
### Additional information
|
||||||
[Trendpop]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-trendpop.png
|
|
||||||
[Cirrus CI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cirrus-ci.png
|
|
||||||
[Basler]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-basler.png
|
|
||||||
[KX]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kx.png
|
|
||||||
[Prefect]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-prefect.png
|
|
||||||
[Zenoss]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-zenoss.png
|
|
||||||
[Posit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-posit.png
|
|
||||||
[n8n]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-n8n.png
|
|
||||||
[Dogado]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-dogado.png
|
|
||||||
[World Wide Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-wwt.png
|
|
||||||
[Coda]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-coda.png
|
|
||||||
[Elastic]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-elastic.png
|
|
||||||
[IP Fabric]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-ip-fabric.png
|
|
||||||
[Apex.AI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-apex-ai.png
|
|
||||||
[Jitterbit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-jitterbit.png
|
|
||||||
[Sparkfun]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sparkfun.png
|
|
||||||
[Eccenca]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-eccenca.png
|
|
||||||
[Neptune]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-neptune-ai.png
|
|
||||||
[Cash App]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cashapp.png
|
|
||||||
[RackN]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-rackn.png
|
|
||||||
[CivicActions]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-civic-actions.png
|
|
||||||
[bitcrowd]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-bitcrowd.png
|
|
||||||
[GetScreen.me]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-getscreenme.png
|
|
||||||
[BotCity]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-botcity.png
|
|
||||||
[Springer Nature Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sn-technology.png
|
|
||||||
[Kolena]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kolena.png
|
|
||||||
[Evergiving]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-evergiving.png
|
|
||||||
[Koor]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-koor.png
|
|
||||||
[Astral]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-astral.png
|
|
||||||
[Oikolab]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-oikolab.png
|
|
||||||
[Bühler Group]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-buhler.png
|
|
||||||
[Transformation Flow]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-transformationflow.png
|
|
||||||
[3DR]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-3dr.png
|
|
||||||
[Spotware]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-spotware.png
|
|
||||||
[Milford Assets]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-milford.png
|
|
||||||
[Lechler]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-lechler.png
|
|
||||||
[SailPoint]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sailpoint.png
|
|
||||||
[Invers]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-invers.png
|
|
||||||
[Maxar]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-maxar.png
|
|
||||||
[EquipmentShare]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-equipmentshare.png
|
|
||||||
|
|
||||||
<hr />
|
If you require additional and detailed information about payment, billing,
|
||||||
|
access management, and more, here is everything you need to know:
|
||||||
|
|
||||||
|
<div class="grid cards" markdown>
|
||||||
|
|
||||||
|
- :material-hand-coin:
|
||||||
|
__Payment and billing__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
All the information you need about payment methods and billing cycles
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More infomation][Payment and billing]
|
||||||
|
|
||||||
|
- :material-key-variant:
|
||||||
|
__Access management__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Learn about access management to Insiders – for individuals and
|
||||||
|
organizations
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More infomation][Access management]
|
||||||
|
|
||||||
|
- :material-clock-time-three:
|
||||||
|
__Runtime and cancellation__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Receive information on the duration of your sponsorship and the cancellation
|
||||||
|
process
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More information][Runtime and cancellation]
|
||||||
|
|
||||||
|
- :material-lock-open:
|
||||||
|
__Privacy__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Our commitment to your privacy – learn assurances on valuing your privacy
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More infomation][Privacy]
|
||||||
|
|
||||||
|
- :material-briefcase:
|
||||||
|
__License__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Get details on the licensing of Material for MkDocs Insiders and its requirements
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More infomation][License]
|
||||||
|
|
||||||
|
- :material-email:
|
||||||
|
__Support__
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Overview of our support options available, ensuring you get the information
|
||||||
|
you need
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[:octicons-arrow-right-24: More information][Support]
|
||||||
|
|
||||||
<div class="mdx-sponsorship" data-mdx-component="sponsorship" hidden>
|
|
||||||
<div class="mdx-sponsorship__list"></div>
|
|
||||||
<small>
|
|
||||||
If you sponsor publicly, you're automatically added here with a link to
|
|
||||||
your profile and avatar to show your support for Material for MkDocs.
|
|
||||||
Alternatively, if you wish to keep your sponsorship private, you'll be a
|
|
||||||
silent +1. You can select visibility during checkout and change it
|
|
||||||
afterwards.
|
|
||||||
</small>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
[squidfunk's sponsor profile]: https://github.com/sponsors/squidfunk?metadata_origin=docs
|
### Using Insiders
|
||||||
|
|
||||||
## Funding <span class="mdx-sponsorship-total" data-mdx-component="sponsorship-total"></span>
|
Once you have become a sponsor, you can start using Material for MkDocs Insiders,
|
||||||
|
get all the information you need to get started:
|
||||||
|
|
||||||
### Goals
|
<div class="grid cards" markdown>
|
||||||
|
|
||||||
The following section lists all funding goals. Each goal contains a list of
|
- :material-download:
|
||||||
features prefixed with a checkmark symbol, denoting whether a feature is
|
__Getting started__
|
||||||
:octicons-check-circle-fill-24:{ style="color: #00e676" } already available or
|
|
||||||
:octicons-check-circle-fill-24:{ style="color: var(--md-default-fg-color--lightest)" } planned, but not yet implemented. When the funding goal is hit, the features
|
|
||||||
are released for general availability.
|
|
||||||
|
|
||||||
#### $ 16,000 – Chipotle
|
---
|
||||||
|
|
||||||
- [x] [Meta plugin]
|
Step-by-step instructions on how to install Material for MkDocs Insiders
|
||||||
- [x] [Blog plugin: related links]
|
|
||||||
- [x] [Blog plugin: custom index pages]
|
|
||||||
- [x] [Tags plugin: configurable listings]
|
|
||||||
- [x] [Tags plugin: allow list] + [custom sorting]
|
|
||||||
- [x] [Navigation subtitles]
|
|
||||||
|
|
||||||
[Meta plugin]: ../plugins/meta.md
|
---
|
||||||
[Blog plugin: related links]: ../setup/setting-up-a-blog.md#adding-related-links
|
|
||||||
[Blog plugin: custom index pages]: ../setup/setting-up-a-blog.md#custom-index-pages
|
|
||||||
[Tags plugin: configurable listings]: ../setup/setting-up-tags.md#configurable-listings
|
|
||||||
[Tags plugin: allow list]: ../plugins/tags.md#config.tags_allowed
|
|
||||||
[custom sorting]: ../plugins/tags.md#config.tags_sort_by
|
|
||||||
[Navigation subtitles]: ../reference/index.md#setting-the-page-subtitle
|
|
||||||
|
|
||||||
#### $ 18,000 – Lemon Drop
|
[:octicons-arrow-right-24: More information][Getting started]
|
||||||
|
|
||||||
- [x] [Optimize plugin]
|
- :octicons-versions-16:
|
||||||
- [x] [Navigation path] (Breadcrumbs)
|
__Changelog__
|
||||||
- [x] [Blog plugin: advanced settings]
|
|
||||||
- [x] [Blog plugin: author profiles]
|
|
||||||
- [x] [Blog plugin: pinned posts]
|
|
||||||
- [x] [Instant prefetching]
|
|
||||||
|
|
||||||
[Optimize plugin]: ../plugins/optimize.md
|
---
|
||||||
[Navigation path]: ../setup/setting-up-navigation.md#navigation-path
|
|
||||||
[Blog plugin: advanced settings]: ../setup/setting-up-a-blog.md#advanced-settings
|
|
||||||
[Blog plugin: author profiles]: ../setup/setting-up-a-blog.md#adding-author-profiles
|
|
||||||
[Blog plugin: pinned posts]: ../setup/setting-up-a-blog.md#pinning-a-post
|
|
||||||
[Instant prefetching]: ../setup/setting-up-navigation.md#instant-prefetching
|
|
||||||
|
|
||||||
#### $ 20,000 – Jalapeño
|
Review the latest changes and additions to Material for MkDocs Insiders
|
||||||
|
|
||||||
- [x] [Typeset plugin]
|
---
|
||||||
- [x] [Footnote tooltips]
|
|
||||||
- [x] [Privacy plugin: advanced settings]
|
|
||||||
- [x] [Privacy plugin: external links]
|
|
||||||
- [ ] to be announced
|
|
||||||
- [ ] to be announced
|
|
||||||
|
|
||||||
[Typeset plugin]: ../plugins/typeset.md
|
[:octicons-arrow-right-24: More infomation][Changelog]
|
||||||
[Footnote tooltips]: ../reference/footnotes.md#footnote-tooltips
|
|
||||||
[Privacy plugin: external links]: ../plugins/privacy.md#external-links
|
|
||||||
[Privacy plugin: advanced settings]: ../setup/ensuring-data-privacy.md#advanced-settings
|
|
||||||
|
|
||||||
#### $ 22,000 – Habanero Orange
|
- :material-update:
|
||||||
|
__Upgrade__
|
||||||
|
|
||||||
- [x] [Instant previews]
|
---
|
||||||
- [x] [Social plugin: custom layouts]
|
|
||||||
- [x] [Social plugin: background images]
|
|
||||||
- [x] [Code range selection]
|
|
||||||
- [x] [Code annotations: custom selectors]
|
|
||||||
- [x] [Stay on page when switching languages]
|
|
||||||
|
|
||||||
[Instant previews]: ../setup/setting-up-navigation.md#instant-previews
|
Stay updated with the latest changes and improvements in the Insiders
|
||||||
[Social plugin: custom layouts]: ../setup/setting-up-social-cards.md#customization
|
edition
|
||||||
[Social plugin: background images]: ../plugins/social.md#option.background_image
|
|
||||||
[Code range selection]: ../reference/code-blocks.md#code-selection-button
|
|
||||||
[Code annotations: custom selectors]: ../reference/code-blocks.md#custom-selectors
|
|
||||||
[Stay on page when switching languages]: ../setup/changing-the-language.md#stay-on-page
|
|
||||||
|
|
||||||
#### $ 24,000 – Blockpaprika
|
---
|
||||||
|
|
||||||
- [x] [Projects plugin]
|
[:octicons-arrow-right-24: More infomation][Upgrade]
|
||||||
- [x] [Tags plugin: nested tags]
|
|
||||||
- [x] [Tags plugin: shadow tags]
|
|
||||||
- [x] [Tags plugin: advanced settings]
|
|
||||||
- [ ] to be announced
|
|
||||||
- [ ] to be announced
|
|
||||||
|
|
||||||
[Projects plugin]: ../plugins/projects.md
|
</div>
|
||||||
[Tags plugin: nested tags]: ../setup/setting-up-tags.md#nested-tags
|
|
||||||
[Tags plugin: shadow tags]: ../setup/setting-up-tags.md#shadow-tags
|
|
||||||
[Tags plugin: advanced settings]: ../setup/setting-up-tags.md#advanced-settings
|
|
||||||
|
|
||||||
|
[Why sponsor us]: why-sponsor-us.md
|
||||||
|
[What's in it for you]: benefits.md
|
||||||
|
[Who is sponsoring]: our-sponsors.md
|
||||||
|
[Sponsoring tiers]: sponsoring-tiers.md
|
||||||
|
[How to sponsor]: how-to-sponsor.md
|
||||||
|
[Payment and billing]: payment-and-billing.md
|
||||||
|
[Access management]: access-management.md
|
||||||
|
[Runtime and cancellation]: runtime-and-cancellation.md
|
||||||
|
[Privacy]: privacy.md
|
||||||
|
[License]: license.md
|
||||||
|
[Support]: ../support.md
|
||||||
|
[Getting started]: getting-started.md
|
||||||
|
[Changelog]: ../changelog/index.md
|
||||||
|
[Upgrade]: upgrade.md
|
||||||
|
|
||||||
### Goals completed
|
----
|
||||||
|
|
||||||
This section lists all funding goals that were previously completed, which means
|
__We're looking forward to welcoming you as a sponsor!__
|
||||||
that those features were part of Insiders, but are now generally available and
|
|
||||||
can be used by all users.
|
|
||||||
|
|
||||||
#### $ 14,000 – Goat's Horn
|
|
||||||
|
|
||||||
- [x] [Privacy plugin]
|
|
||||||
- [x] [Card grids]
|
|
||||||
- [x] [Tooltips]
|
|
||||||
- [x] [Content tabs: anchor links]
|
|
||||||
- [x] [Automatic light / dark mode]
|
|
||||||
- [x] [Document contributors]
|
|
||||||
|
|
||||||
[Privacy plugin]: ../setup/ensuring-data-privacy.md#built-in-privacy-plugin
|
|
||||||
[Card grids]: ../reference/grids.md
|
|
||||||
[Tooltips]: ../reference/tooltips.md
|
|
||||||
[Content tabs: anchor links]: ../reference/content-tabs.md#anchor-links
|
|
||||||
[Automatic light / dark mode]: ../setup/changing-the-colors.md#automatic-light-dark-mode
|
|
||||||
[Document contributors]: ../setup/adding-a-git-repository.md#document-contributors
|
|
||||||
|
|
||||||
#### $ 12,000 – Piri Piri
|
|
||||||
|
|
||||||
- [x] [Blog plugin]
|
|
||||||
- [x] [Chinese search support]
|
|
||||||
- [x] [Annotations]
|
|
||||||
- [x] [Navigation icons]
|
|
||||||
- [x] [Navigation pruning]
|
|
||||||
- [x] [Navigation status]
|
|
||||||
|
|
||||||
[Blog plugin]: ../setup/setting-up-a-blog.md
|
|
||||||
[Chinese search support]: ../blog/posts/chinese-search-support.md
|
|
||||||
[Annotations]: ../reference/annotations.md
|
|
||||||
[Navigation icons]: ../reference/index.md#setting-the-page-icon
|
|
||||||
[Navigation pruning]: ../setup/setting-up-navigation.md#navigation-pruning
|
|
||||||
[Navigation status]: ../reference/index.md#setting-the-page-status
|
|
||||||
|
|
||||||
#### $ 10,000 – Carolina Reaper
|
|
||||||
|
|
||||||
- [x] [Brand new search plugin]
|
|
||||||
- [x] [Rich search previews]
|
|
||||||
- [x] [Tokenizer with lookahead]
|
|
||||||
- [x] [Advanced search highlighting]
|
|
||||||
- [x] [Excluding content from search]
|
|
||||||
- [x] [Offline plugin]
|
|
||||||
|
|
||||||
[Brand new search plugin]: ../blog/posts/search-better-faster-smaller.md
|
|
||||||
[Rich search previews]: ../blog/posts/search-better-faster-smaller.md#rich-search-previews
|
|
||||||
[Tokenizer with lookahead]: ../blog/posts/search-better-faster-smaller.md#tokenizer-lookahead
|
|
||||||
[Advanced search highlighting]: ../blog/posts/search-better-faster-smaller.md#accurate-highlighting
|
|
||||||
[Excluding content from search]: ../setup/setting-up-site-search.md#search-exclusion
|
|
||||||
[Offline plugin]: ../setup/building-for-offline-usage.md
|
|
||||||
|
|
||||||
#### $ 8,000 – Scotch Bonnet
|
|
||||||
|
|
||||||
- [x] [Social cards]
|
|
||||||
- [x] Code annotations: anchor links
|
|
||||||
- [x] [Code annotations: strip comments]
|
|
||||||
- [x] [Tag icons]
|
|
||||||
- [x] [Table of contents anchor following]
|
|
||||||
- [x] Sidebars automatically scroll to active item
|
|
||||||
|
|
||||||
[Social cards]: ../setup/setting-up-social-cards.md
|
|
||||||
[Code annotations: strip comments]: ../reference/code-blocks.md#stripping-comments
|
|
||||||
[Tag icons]: ../setup/setting-up-tags.md#tag-icons-and-identifiers
|
|
||||||
[Table of contents anchor following]: ../setup/setting-up-navigation.md#anchor-following
|
|
||||||
|
|
||||||
#### $ 7,000 – Royal Gold
|
|
||||||
|
|
||||||
- [x] [Cookie consent]
|
|
||||||
- [x] [Was this page helpful?]
|
|
||||||
- [x] [Dismissable announcement bar]
|
|
||||||
|
|
||||||
[Cookie consent]: ../setup/ensuring-data-privacy.md#cookie-consent
|
|
||||||
[Was this page helpful?]: ../setup/setting-up-site-analytics.md#was-this-page-helpful
|
|
||||||
[Dismissable announcement bar]: ../setup/setting-up-the-header.md#mark-as-read
|
|
||||||
|
|
||||||
#### $ 6,000 – Trinidad Scorpion
|
|
||||||
|
|
||||||
- [x] [Boosting pages in search]
|
|
||||||
- [x] [Custom admonition icons]
|
|
||||||
- [x] [Linking content tabs]
|
|
||||||
|
|
||||||
[Boosting pages in search]: ../setup/setting-up-site-search.md#search-boosting
|
|
||||||
[Custom admonition icons]: ../reference/admonitions.md#admonition-icons
|
|
||||||
[Linking content tabs]: ../reference/content-tabs.md#linked-content-tabs
|
|
||||||
|
|
||||||
#### $ 5,000 – Aji Panca
|
|
||||||
|
|
||||||
- [x] [Mermaid.js integration]
|
|
||||||
- [x] Stay on page when switching versions
|
|
||||||
- [x] [Tags with search integration]
|
|
||||||
|
|
||||||
[Mermaid.js integration]: ../reference/diagrams.md
|
|
||||||
[Tags with search integration]: ../setup/setting-up-tags.md
|
|
||||||
|
|
||||||
#### $ 4,000 – Ghost Pepper
|
|
||||||
|
|
||||||
- [x] [Anchor tracking]
|
|
||||||
- [x] [Code annotations]
|
|
||||||
- [x] [Version warning]
|
|
||||||
|
|
||||||
[Anchor tracking]: ../setup/setting-up-navigation.md#anchor-tracking
|
|
||||||
[Code annotations]: ../reference/code-blocks.md#adding-annotations
|
|
||||||
[Version warning]: ../setup/setting-up-versioning.md#version-warning
|
|
||||||
|
|
||||||
#### $ 3,000 – Caribbean Red
|
|
||||||
|
|
||||||
- [x] [Sticky navigation tabs]
|
|
||||||
- [x] [Section index pages]
|
|
||||||
- [x] [Remove generator notice]
|
|
||||||
|
|
||||||
[Sticky navigation tabs]: ../setup/setting-up-navigation.md#sticky-navigation-tabs
|
|
||||||
[Section index pages]: ../setup/setting-up-navigation.md#section-index-pages
|
|
||||||
[Remove generator notice]: ../setup/setting-up-the-footer.md#generator-notice
|
|
||||||
|
|
||||||
#### $ 2,500 – Biquinho Vermelho
|
|
||||||
|
|
||||||
- [x] [Search suggestions]
|
|
||||||
- [x] [Search highlighting]
|
|
||||||
- [x] [Search sharing]
|
|
||||||
|
|
||||||
[Search suggestions]: ../setup/setting-up-site-search.md#search-suggestions
|
|
||||||
[Search highlighting]: ../setup/setting-up-site-search.md#search-highlighting
|
|
||||||
[Search sharing]: ../setup/setting-up-site-search.md#search-sharing
|
|
||||||
|
|
||||||
#### $ 2,000 – Black Pearl
|
|
||||||
|
|
||||||
- [x] Latest release tag
|
|
||||||
- [x] [Color palette toggle]
|
|
||||||
- [x] [Back-to-top button]
|
|
||||||
|
|
||||||
[Color palette toggle]: ../setup/changing-the-colors.md#color-palette-toggle
|
|
||||||
[Back-to-top button]: ../setup/setting-up-navigation.md#back-to-top-button
|
|
||||||
|
|
||||||
#### $ 1,500 – Bhut Jolokia
|
|
||||||
|
|
||||||
- [x] [Admonition inline blocks]
|
|
||||||
- [x] [Site language selection]
|
|
||||||
- [x] [Versioning]
|
|
||||||
|
|
||||||
[Admonition inline blocks]: ../reference/admonitions.md#inline-blocks
|
|
||||||
[Site language selection]: ../setup/changing-the-language.md#site-language-selector
|
|
||||||
[Versioning]: ../setup/setting-up-versioning.md#versioning
|
|
||||||
|
|
||||||
#### $ 1,000 – Prairie Fire
|
|
||||||
|
|
||||||
- [x] [Navigation sections]
|
|
||||||
- [x] [Navigation expansion]
|
|
||||||
- [x] [Hiding the sidebars]
|
|
||||||
- [x] [Table of contents in navigation]
|
|
||||||
- [x] [Header hides on scroll]
|
|
||||||
|
|
||||||
[Navigation sections]: ../setup/setting-up-navigation.md#navigation-sections
|
|
||||||
[Navigation expansion]: ../setup/setting-up-navigation.md#navigation-expansion
|
|
||||||
[Hiding the sidebars]: ../setup/setting-up-navigation.md#hiding-the-sidebars
|
|
||||||
[Table of contents in navigation]: ../setup/setting-up-navigation.md#navigation-integration
|
|
||||||
[Header hides on scroll]: ../setup/setting-up-the-header.md#automatic-hiding
|
|
||||||
|
|
||||||
#### $ 500 – Madame Jeanette
|
|
||||||
|
|
||||||
- [x] Improved search result grouping
|
|
||||||
- [x] Improved search result relevance and scoring
|
|
||||||
- [x] Missing query terms in search results
|
|
||||||
|
|
||||||
## Frequently asked questions
|
|
||||||
|
|
||||||
### Compatibility
|
|
||||||
|
|
||||||
_We're building an open source project and want to allow outside collaborators
|
|
||||||
to run and build our documentation locally without having access to Insiders.
|
|
||||||
Is this still possible?_
|
|
||||||
|
|
||||||
Yes. Insiders is compatible with Material for MkDocs. Almost all new features
|
|
||||||
and configuration options are either backward-compatible or implemented behind
|
|
||||||
feature flags. When working with outside collaborators, it should be rarely
|
|
||||||
necessary to change the general appearance of your site. Most Insiders features
|
|
||||||
enhance the overall experience, e.g. by adding icons to pages or providing a
|
|
||||||
feedback widget. While these features add value for the user of your site, they
|
|
||||||
shouldn't be necessary for previewing when making changes to content. Currently,
|
|
||||||
the only content-related features in Insiders that can't be properly previewed
|
|
||||||
by non-Insiders users are:
|
|
||||||
|
|
||||||
- [Annotations]
|
|
||||||
- [Card grids]
|
|
||||||
|
|
||||||
This means that outside collaborators are able to build the documentation
|
|
||||||
locally with Material for MkDocs and when they push their changes, your CI
|
|
||||||
pipeline will build it with Insiders. When using built-in plugins that are
|
|
||||||
exclusive to Insiders, it's recommended to split configuration into a base
|
|
||||||
`mkdocs.yml` and one with plugin overrides via [configuration inheritance].
|
|
||||||
|
|
||||||
See the [getting started guide] for more information.
|
|
||||||
|
|
||||||
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
|
|
||||||
[getting started guide]: getting-started.md
|
|
||||||
|
|
||||||
### Payment
|
|
||||||
|
|
||||||
_We don't want to pay for sponsorship every month. Are there any other options?_
|
|
||||||
|
|
||||||
Yes. You can sponsor on a yearly basis by [switching your GitHub account to a
|
|
||||||
yearly billing cycle][billing cycle]. If for some reason you cannot do that, you
|
|
||||||
could also create a dedicated GitHub account with a yearly billing cycle, which
|
|
||||||
you only use for sponsoring (some sponsors already do that).
|
|
||||||
|
|
||||||
If you have any problems or further questions, please reach out to
|
|
||||||
sponsors@squidfunk.com.
|
|
||||||
|
|
||||||
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
|
|
||||||
|
|
||||||
### Terms
|
|
||||||
|
|
||||||
_Are we allowed to use Insiders under the same terms and conditions as
|
|
||||||
Material for MkDocs?_
|
|
||||||
|
|
||||||
Yes. 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]. However, we kindly ask you to respect our
|
|
||||||
__fair use policy__:
|
|
||||||
|
|
||||||
- Please __don't distribute the source code__ of Insiders. You may freely use
|
|
||||||
it for public, private or commercial projects, privately fork or mirror it,
|
|
||||||
but please don't make the source code public, as it would counteract the
|
|
||||||
sponsorware strategy.
|
|
||||||
|
|
||||||
- If you cancel your subscription, you're automatically removed as a
|
|
||||||
collaborator and will miss out on all future updates of 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].
|
|
||||||
|
|
||||||
[MIT license]: ../license.md
|
|
||||||
[GitHub deletes private forks]: https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository
|
|
||||||
|
64
docs/insiders/license.md
Normal file
64
docs/insiders/license.md
Normal file
@ -0,0 +1,64 @@
|
|||||||
|
# License
|
||||||
|
|
||||||
|
Material for MkDocs Insiders is licensed under the [MIT license], the exact
|
||||||
|
same license used for the community edition. The MIT license is a permissive
|
||||||
|
license that allows commercial use, redistribution, and everything else as
|
||||||
|
long as the original authors are credited in source files.
|
||||||
|
|
||||||
|
The MIT license is the [most popular license] among all Open Source projects.
|
||||||
|
|
||||||
|
[MIT license]: https://opensource.org/license/mit
|
||||||
|
[most popular license]: https://opensource.org/blog/the-most-popular-licenses-for-each-language-2023
|
||||||
|
|
||||||
|
## MIT License
|
||||||
|
|
||||||
|
The MIT License gives you the freedom to work with the code with minimal
|
||||||
|
restrictions. When using Material for MkDocs Insiders or the community edition,
|
||||||
|
make sure to __include the copyright notice__ and avoid future liability claims.
|
||||||
|
Its appeal lies in its simplicity and clear terms, making it a go-to for
|
||||||
|
projects of any scale. Its popularity stems from its simplicity, clarity,
|
||||||
|
and development-friendly terms, making it suitable for all types of projects.
|
||||||
|
The MIT License ensures that anyone – individual or organization – can use
|
||||||
|
Material for MkDocs Insiders under the same conditions as the community edition.
|
||||||
|
|
||||||
|
### Advantages of MIT
|
||||||
|
|
||||||
|
The MIT License is favored for its balance between freedom and protection,
|
||||||
|
appealing to those who find GNU/GPL licenses too restrictive or advocate for
|
||||||
|
privatized software. Its broad wording supports both open community development
|
||||||
|
and the use of components in proprietary software.
|
||||||
|
|
||||||
|
### MIT in open source
|
||||||
|
|
||||||
|
Material for MkDocs stands out for being open source, developed by a small,
|
||||||
|
user-oriented team committed to delivering high-quality tools for the community.
|
||||||
|
Here’s what this means for you:
|
||||||
|
|
||||||
|
- __Independence from investors:__ Our focus is purely on developing the
|
||||||
|
project and guiding it without external pressures. This freedom means we’re all
|
||||||
|
about what’s best for the community and the project's future.
|
||||||
|
- __Freedom from vendor lock-in:__ Thanks to Open Source principles, you can use
|
||||||
|
Material for MkDocs without any strings attached. Customize or integrate it
|
||||||
|
into your projects without worrying about restrictions. Your docs belong to you,
|
||||||
|
and you are free to change the software at any time.
|
||||||
|
- __Ecosystem Development:__ Material for MkDocs is more than a tool; it's a
|
||||||
|
community-driven effort to build an ecosystem, which it already is. Through open
|
||||||
|
collaboration, we’re constantly adding new extensions, plugins, and integrations
|
||||||
|
to give you more tools at your disposal.
|
||||||
|
|
||||||
|
## Fair use policy
|
||||||
|
|
||||||
|
Our fair use policy is here to ensure the project continues to thrive, which is
|
||||||
|
why we request that our sponsors respect the following:
|
||||||
|
|
||||||
|
- __Source Code Distribution:__ Keeping our sponsorware model intact means we
|
||||||
|
count on you not to distribute the Insiders source code. While you're encouraged
|
||||||
|
to privately [fork], or [mirror] the private Insiders repository for your needs,
|
||||||
|
__keeping the source private__ is key. If this guideline is violated,
|
||||||
|
everybody loses, as it will reduce the time of us maintainers we could otherwise
|
||||||
|
set aside to push this project forward.
|
||||||
|
- __Sponsorship tiers:__ We base our sponsorship tiers on non-commercial or
|
||||||
|
commercial use and ask our sponsors to respect these requirements when
|
||||||
|
initiating a sponsorship. Additionally, we base our sponsoring tiers on the number
|
||||||
|
of sites you intend to build. Please upgrade your sponsorship accordingly to
|
||||||
|
support the project’s growth and ensure its continued development.
|
127
docs/insiders/our-sponsors.md
Normal file
127
docs/insiders/our-sponsors.md
Normal file
@ -0,0 +1,127 @@
|
|||||||
|
# Our sponsors
|
||||||
|
|
||||||
|
Starting in 2020, we have managed to build a community of a few hundred sponsors
|
||||||
|
that support us every month, for which we are immensely grateful. Without their
|
||||||
|
financial support, Material for MkDocs wouldn't be anywhere near where it is
|
||||||
|
today.
|
||||||
|
|
||||||
|
<div class="mdx-premium" markdown>
|
||||||
|
|
||||||
|
## Premium sponsors
|
||||||
|
|
||||||
|
### Gold sponsors
|
||||||
|
|
||||||
|
_Be our first gold sponsor!_
|
||||||
|
|
||||||
|
----
|
||||||
|
|
||||||
|
### Silver sponsors
|
||||||
|
|
||||||
|
[![FastAPI]{ style="height: 120px" }](https://fastapi.tiangolo.com/){ target=_blank title="FastAPI" }
|
||||||
|
[![Trendpop]{ style="height: 120px" }](https://www.trendpop.com/){ target=_blank title="Trendpop" }
|
||||||
|
[![SailPoint]{ style="height: 120px" }](https://documentation.sailpoint.com/){ target=_blank title="SailPoint" }
|
||||||
|
|
||||||
|
----
|
||||||
|
|
||||||
|
### Bronze sponsors
|
||||||
|
|
||||||
|
[![Cirrus CI]](https://cirrus-ci.org/){ target=_blank title="Cirrus CI" }
|
||||||
|
[![Basler]](https://docs.baslerweb.com/){ target=_blank title="Basler" }
|
||||||
|
[![KX]](https://kx.com/){ target=_blank title="KX Systems" }
|
||||||
|
[![Prefect]](https://orion-docs.prefect.io/){ target=_blank title="Prefect" }
|
||||||
|
[![Zenoss]](https://zenoss.com/){ target=_blank title="Zenoss" }
|
||||||
|
[![Posit]](https://docs.posit.co){ target=_blank title="Posit" }
|
||||||
|
[![n8n]](https://n8n.io){ target=_blank title="n8n" }
|
||||||
|
[![Dogado]](https://www.dogado.de){ target=_blank title="Dogado" }
|
||||||
|
[![World Wide Technology]](https://wwt.com){ target=_blank title="World Wide Technology" }
|
||||||
|
[![Coda]](https://coda.io){ target=_blank title="Coda" }
|
||||||
|
[![Elastic]](https://elastic.co){ target=_blank title="Elastic" }
|
||||||
|
[![IP Fabric]](https://ipfabric.io/){ target=_blank title="IP Fabric" }
|
||||||
|
[![Apex.AI]](https://www.apex.ai/){ target=_blank title="Apex.AI" }
|
||||||
|
[![Jitterbit]](https://jitterbit.com/){ target=_blank title="Jitterbit" }
|
||||||
|
[![Sparkfun]](https://sparkfun.com/){ target=_blank title="Sparkfun Electronics" }
|
||||||
|
[![Eccenca]](https://eccenca.com/){ target=_blank title="Eccenca" }
|
||||||
|
[![Neptune]](https://neptune.ai/){ target=_blank title="Neptune" }
|
||||||
|
[![RackN]](https://rackn.com/){ target=_blank title="RackN" }
|
||||||
|
[![CivicActions]](https://civicactions.com/){ target=_blank title="CivicActions" }
|
||||||
|
[![bitcrowd]](https://bitcrowd.net/){ target=_blank title="bitcrowd" }
|
||||||
|
[![GetScreen.me]](https://getscreen.me/){ target=_blank title="GetScreen.me" }
|
||||||
|
[![BotCity]](https://botcity.dev/){ target=_blank title="BotCity" }
|
||||||
|
[![Springer Nature Technology]](https://www.springernature.com/gp){ target=_blank title="Springer Nature Technology" }
|
||||||
|
[![Kolena]](https://kolena.io/){ target=_blank title="Kolena" }
|
||||||
|
[![Evergiving]](https://www.evergiving.com/){ target=_blank title="Evergiving" }
|
||||||
|
[![Koor]](https://koor.tech/){ target=_blank title="Koor" }
|
||||||
|
[![Astral]](https://astral.sh/){ target=_blank title="Astral" }
|
||||||
|
[![Oikolab]](https://oikolab.com/){ target=_blank title="Oikolab" }
|
||||||
|
[![Bühler Group]](https://www.buhlergroup.com/){ target=_blank title="Bühler Group" }
|
||||||
|
[![Transformation Flow]](https://transformationflow.io/){ target=_blank title="Transformation Flow" }
|
||||||
|
[![3DR]](https://3dr.com/){ target=_blank title="3DR" }
|
||||||
|
[![Spotware]](https://spotware.com/){ target=_blank title="Spotware" }
|
||||||
|
[![Milford Assets]](https://milfordasset.com/){ target=_blank title="Milford Assets" }
|
||||||
|
[![Lechler]](https://www.lechler.com/){ target=_blank title="Lechler" }
|
||||||
|
[![Invers]](https://invers.com/){ target=_blank title="Invers" }
|
||||||
|
[![Maxar]](https://maxar.com/){ target=_blank title="Maxar" }
|
||||||
|
[![EquipmentShare]](https://www.equipmentshare.com/){ target=_blank title="EquipmentShare" }
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
[FastAPI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-fastapi.png
|
||||||
|
[Trendpop]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-trendpop.png
|
||||||
|
[Cirrus CI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cirrus-ci.png
|
||||||
|
[Basler]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-basler.png
|
||||||
|
[KX]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kx.png
|
||||||
|
[Prefect]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-prefect.png
|
||||||
|
[Zenoss]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-zenoss.png
|
||||||
|
[Posit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-posit.png
|
||||||
|
[n8n]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-n8n.png
|
||||||
|
[Dogado]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-dogado.png
|
||||||
|
[World Wide Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-wwt.png
|
||||||
|
[Coda]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-coda.png
|
||||||
|
[Elastic]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-elastic.png
|
||||||
|
[IP Fabric]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-ip-fabric.png
|
||||||
|
[Apex.AI]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-apex-ai.png
|
||||||
|
[Jitterbit]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-jitterbit.png
|
||||||
|
[Sparkfun]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sparkfun.png
|
||||||
|
[Eccenca]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-eccenca.png
|
||||||
|
[Neptune]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-neptune-ai.png
|
||||||
|
[Cash App]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-cashapp.png
|
||||||
|
[RackN]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-rackn.png
|
||||||
|
[CivicActions]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-civic-actions.png
|
||||||
|
[bitcrowd]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-bitcrowd.png
|
||||||
|
[GetScreen.me]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-getscreenme.png
|
||||||
|
[BotCity]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-botcity.png
|
||||||
|
[Springer Nature Technology]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sn-technology.png
|
||||||
|
[Kolena]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-kolena.png
|
||||||
|
[Evergiving]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-evergiving.png
|
||||||
|
[Koor]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-koor.png
|
||||||
|
[Astral]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-astral.png
|
||||||
|
[Oikolab]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-oikolab.png
|
||||||
|
[Bühler Group]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-buhler.png
|
||||||
|
[Transformation Flow]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-transformationflow.png
|
||||||
|
[3DR]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-3dr.png
|
||||||
|
[Spotware]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-spotware.png
|
||||||
|
[Milford Assets]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-milford.png
|
||||||
|
[Lechler]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-lechler.png
|
||||||
|
[SailPoint]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-sailpoint.png
|
||||||
|
[Invers]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-invers.png
|
||||||
|
[Maxar]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-maxar.png
|
||||||
|
[EquipmentShare]: https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/sponsor-equipmentshare.png
|
||||||
|
|
||||||
|
<hr />
|
||||||
|
|
||||||
|
[ :material-arrow-up-bold: Add yourself to the list <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][sponsoring-tiers]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[sponsoring-tiers]: sponsoring-tiers.md
|
||||||
|
|
||||||
|
## All sponsors
|
||||||
|
|
||||||
|
<div class="mdx-sponsorship" data-mdx-component="sponsorship" hidden>
|
||||||
|
<div class="mdx-sponsorship__list"></div>
|
||||||
|
<small>
|
||||||
|
If you sponsor publicly, you're automatically added here with a link to
|
||||||
|
your profile and avatar to show your support for Material for MkDocs.
|
||||||
|
Alternatively, if you wish to keep your sponsorship private, you'll be a
|
||||||
|
silent +1. You can select visibility during checkout and change it
|
||||||
|
afterwards.
|
||||||
|
</small>
|
||||||
|
</div>
|
94
docs/insiders/payment-and-billing.md
Normal file
94
docs/insiders/payment-and-billing.md
Normal file
@ -0,0 +1,94 @@
|
|||||||
|
# Payment and billing
|
||||||
|
|
||||||
|
Since we host our repositories on GitHub, including both the Material for MkDocs
|
||||||
|
community edition and the private Insiders edition, [GitHub Sponsors] is a
|
||||||
|
natural fit for handling all financial transactions, as well as for access
|
||||||
|
management to the Insiders repository.
|
||||||
|
|
||||||
|
Therefore, to become a sponsor of Material for MkDocs, a [GitHub account] is mandatory.
|
||||||
|
|
||||||
|
[GitHub Sponsors]: https://github.com/sponsors
|
||||||
|
[GitHub account]: https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github
|
||||||
|
|
||||||
|
## Payment
|
||||||
|
|
||||||
|
GitHub Sponsors currently only accepts payments via credit card, as they
|
||||||
|
[removed support for PayPal] at the beginning of 2023. When
|
||||||
|
entering your credit card details, ensure that the card remains [valid over an
|
||||||
|
extended period] to prevent any disruptions to your sponsorship.
|
||||||
|
|
||||||
|
[valid over an extended period]: runtime-and-cancellation.md#automatic-cancellation
|
||||||
|
[removed support for PayPal]: https://github.blog/changelog/2023-01-23-github-sponsors-will-stop-supporting-paypal/
|
||||||
|
|
||||||
|
## Invoices
|
||||||
|
|
||||||
|
GitHub Sponsors automatically issues and send a payment receipt via email after
|
||||||
|
each billing cycle. These receipts serve as confirmation of payment rather than
|
||||||
|
formal invoices. As all transactions are managed by [GitHub Sponsors], GitHub is
|
||||||
|
your primary point of contact for payment and billing matters, not us.
|
||||||
|
|
||||||
|
If you need an official invoice from us for your records, please get in touch
|
||||||
|
with us at sponsors@squidfunk.com before initiating your sponsorship.
|
||||||
|
|
||||||
|
## Refunds
|
||||||
|
|
||||||
|
Our team does not have insights or access to details related to sponsorship
|
||||||
|
transactions of our sponsors, as GitHub does not provide us with this
|
||||||
|
information. For questions regarding payment issues or for more detailed
|
||||||
|
information about your sponsorship, please get in touch with the [GitHub
|
||||||
|
support] team.
|
||||||
|
|
||||||
|
[GitHub support]: https://support.github.com/
|
||||||
|
|
||||||
|
## Discounts
|
||||||
|
|
||||||
|
Unfortunately, we can't offer discounts. To ensure that everyone in our
|
||||||
|
community can afford to become a sponsor, we keep the barrier low and set
|
||||||
|
prices as low as possible, starting at [\$15 a month][15] for
|
||||||
|
[non-commercial use] and at [\$125 a month][125] for [commercial use].
|
||||||
|
|
||||||
|
[15]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638
|
||||||
|
[125]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210643
|
||||||
|
[non-commercial use]: sponsoring-tiers.md/#non-commercial-use
|
||||||
|
[commercial use]: sponsoring-tiers.md/#commercial-use
|
||||||
|
|
||||||
|
## Free access
|
||||||
|
|
||||||
|
Free access to the Insiders edition is only granted exclusively to our [Community
|
||||||
|
Experts] and to selected members of the MkDocs ecosystem. Our Community Experts
|
||||||
|
program is designed to recognize and reward users who significantly contribute
|
||||||
|
to the community by sharing their expertise on our [discussion board].
|
||||||
|
|
||||||
|
Our discussion board facilitates the exchange of insights on workarounds, setups,
|
||||||
|
and features and addresses queries from users at all levels of experience. All
|
||||||
|
communication is public and visible for the entire community, benefitting
|
||||||
|
everyone.
|
||||||
|
|
||||||
|
Community experts not only enrich our project but also enable our team to focus
|
||||||
|
on continuous improvement and the development of new features. Therefore, we are
|
||||||
|
happy to provide them with free access to the private Insiders repository and
|
||||||
|
encourage you to [join the team] as well!
|
||||||
|
|
||||||
|
[community experts]: community-experts-program/index.md
|
||||||
|
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
|
||||||
|
[join the team]: community-experts-program/index.md/#ready-to-get-started
|
||||||
|
|
||||||
|
## Billing cycle
|
||||||
|
|
||||||
|
The [billing cycle] is an account-level setting on GitHub and is set to monthly
|
||||||
|
or yearly. It can be changed at any time, so you might want to check the setting
|
||||||
|
before sponsoring and change it either to monthly or yearly according to your
|
||||||
|
own or your organization's preferences.
|
||||||
|
|
||||||
|
If, for whatever reason, you cannot change your billing cycle, a practical
|
||||||
|
solution is to create a dedicated [GitHub bot account] where you set the billing
|
||||||
|
cycle accordingly and use it specifically for your sponsorship contributions.
|
||||||
|
This is a strategy many of our organizational sponsors have successfully
|
||||||
|
implemented.
|
||||||
|
|
||||||
|
If you experience any difficulties or have further questions before sponsoring,
|
||||||
|
please don't hesitate to contact us at sponsors@squidfunk.com for additional
|
||||||
|
support.
|
||||||
|
|
||||||
|
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
|
||||||
|
[GitHub bot account]: https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github
|
79
docs/insiders/privacy.md
Normal file
79
docs/insiders/privacy.md
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
# Privacy
|
||||||
|
|
||||||
|
Transparency is at the heart of our sponsorware model, which includes our
|
||||||
|
funding goals, the features we're working towards, and, importantly, the
|
||||||
|
acknowledgment of our sponsors. As a sponsor, you can support our project
|
||||||
|
either [publicly] or [privately], according to your preference.
|
||||||
|
|
||||||
|
[publicly]: #public-sponsors
|
||||||
|
[privately]: #private-sponsors
|
||||||
|
|
||||||
|
## Public sponsors
|
||||||
|
|
||||||
|
By default, GitHub lists all sponsorships publicly. To sponsor privately, you
|
||||||
|
must explicitly select this option. When sponsoring publicly, your GitHub
|
||||||
|
account will be listed as part of [our sponsors], @squidfunk's [sponsoring page],
|
||||||
|
and within the "sponsoring" section of your GitHub account.
|
||||||
|
|
||||||
|
[our sponsors]: our-sponsors.md
|
||||||
|
[sponsoring page]: https://github.com/sponsors/squidfunk?metadata_origin=docs
|
||||||
|
|
||||||
|
## Private sponsors
|
||||||
|
|
||||||
|
For those preferring discretion, [setting your sponsorship to private] during
|
||||||
|
the sponsorship initiation process ensures your sponsorship remains unlisted,
|
||||||
|
keeping your affiliation with Material for MkDocs confidential.
|
||||||
|
|
||||||
|
This setting can be adjusted at any time through your GitHub account's
|
||||||
|
sponsorship settings.
|
||||||
|
|
||||||
|
For companies concerned about being visible as sponsors of any project due to
|
||||||
|
their privacy restrictions, creating a [bot account] on GitHub that is solely
|
||||||
|
used for sponsoring is advised. This account, set to sponsor privately, won't be
|
||||||
|
linked to any individual within your organization and provides an extra layer of anonymity.
|
||||||
|
|
||||||
|
[setting your sponsorship to private]: https://docs.github.com/en/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship#managing-the-privacy-setting-for-your-sponsorship
|
||||||
|
[bot account]: access-management.md/#bot-account
|
||||||
|
|
||||||
|
## Administrative requests
|
||||||
|
|
||||||
|
To focus on the development of our projects, we aim to reduce administrative
|
||||||
|
tasks as much as possible for our small team, utilizing GitHub Sponsors for
|
||||||
|
efficient sponsor management.
|
||||||
|
|
||||||
|
### Vendor agreements
|
||||||
|
|
||||||
|
Since GitHub Sponsors facilitates our sponsor transactions, they act as your
|
||||||
|
vendor. For vendor agreements or related queries, especially for organizations
|
||||||
|
with GitHub enterprise accounts, reaching out to [GitHub Support] is recommended.
|
||||||
|
|
||||||
|
[GitHub Support]: https://github.com/sponsors
|
||||||
|
|
||||||
|
### Non-disclosure agreements
|
||||||
|
|
||||||
|
Given our limited resources as a small team, we are unable to review and sign
|
||||||
|
NDAs. We advise those requiring such agreements to consult [our promise] for
|
||||||
|
reassurance. Additionally, please contact us if you have any questions at
|
||||||
|
sponsors@squidfunk.com
|
||||||
|
|
||||||
|
[our promise]: #our-promise
|
||||||
|
|
||||||
|
## Our promise
|
||||||
|
|
||||||
|
We recognize the importance of privacy for our organizational sponsors,
|
||||||
|
especially in the absence of formal agreements like [NDAs]. "Our Promise" is our
|
||||||
|
assurance of commitment to your confidentiality and discretion.
|
||||||
|
|
||||||
|
- __Confidential sponsorship:__ Your choice between public or private
|
||||||
|
sponsorship is respected to the fullest. For private sponsors, we guarantee your
|
||||||
|
relation with us remains confidential at all times, ensuring no public disclosure
|
||||||
|
of your sponsorship.
|
||||||
|
- __Logo usage and brand representation:__ Logo display and any form of public
|
||||||
|
acknowledgment are completely under your control and will only proceed with your
|
||||||
|
explicit consent. This ensures your brand is represented on your terms.
|
||||||
|
- __Marketing and communication:__ We commit not to use the details of your
|
||||||
|
sponsorship for marketing or promotional purposes without your approval.
|
||||||
|
Your sponsorship details are guarded with the highest level of confidentiality,
|
||||||
|
with no unauthorized use or disclosure.
|
||||||
|
|
||||||
|
[NDAs]: #non-disclosure-agreements
|
58
docs/insiders/runtime-and-cancellation.md
Normal file
58
docs/insiders/runtime-and-cancellation.md
Normal file
@ -0,0 +1,58 @@
|
|||||||
|
# Runtime and cancellation
|
||||||
|
|
||||||
|
The sponsorship model for Material for MkDocs is facilitated through GitHub
|
||||||
|
Sponsors and, therefore, adheres to GitHub's policies. If you're curious about
|
||||||
|
the duration of your sponsorship and the cancellation process, you will find
|
||||||
|
everything you need to know below.
|
||||||
|
|
||||||
|
## Runtime
|
||||||
|
|
||||||
|
Sponsorships remain valid as long as monthly or yearly subscriptions are
|
||||||
|
active and only expire when you cancel the sponsorship or when your [payment
|
||||||
|
method expires].
|
||||||
|
|
||||||
|
[payment method expires]: #automatic-cancellation
|
||||||
|
|
||||||
|
## Cancellation process
|
||||||
|
|
||||||
|
Canceling your sponsorship initiates a cancellation request through GitHub,
|
||||||
|
which is scheduled to take effect at the end of your current billing cycle. This
|
||||||
|
means you'll retain access to Insiders until the cancellation officially becomes
|
||||||
|
effective.
|
||||||
|
|
||||||
|
All transactions are processed by GitHub and as we don't receive any information
|
||||||
|
regarding your payment, we can't provide details about when your cancellation
|
||||||
|
will be in place.
|
||||||
|
|
||||||
|
### How to cancel
|
||||||
|
|
||||||
|
To downgrade or cancel your sponsorship, please follow the [step-by-step guide
|
||||||
|
from GitHub]. If you have sponsored using an organizational account, ensure that
|
||||||
|
you cancel the sponsorship under that specific account, as the
|
||||||
|
[collaborator and sponsor accounts may differ].
|
||||||
|
|
||||||
|
[step-by-step guide from GitHub]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/downgrading-a-sponsorship#canceling-a-sponsorship
|
||||||
|
[collaborator and sponsor accounts may differ]: access-management.md/#collaborators
|
||||||
|
|
||||||
|
### Effects of cancellation
|
||||||
|
|
||||||
|
Upon the effective date of your cancellation, GitHub will automatically remove
|
||||||
|
you as a collaborator from the private Material for MkDocs Insiders repository.
|
||||||
|
You will no longer receive updates. However, you are welcome to continue using
|
||||||
|
the latest version available to you at the time of cancellation for as long as
|
||||||
|
you like.
|
||||||
|
|
||||||
|
!!! warning "GitHub deletes private forks"
|
||||||
|
|
||||||
|
Please note that once you lose your collaborator status, [GitHub will
|
||||||
|
automatically delete your private fork] of the Insiders repository, so you
|
||||||
|
may want to take steps to ensure that you have a local backup.
|
||||||
|
|
||||||
|
[GitHub will automatically delete your private fork]: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository#deleting-forks-of-private-repositories
|
||||||
|
|
||||||
|
### Automatic cancellation
|
||||||
|
|
||||||
|
If your credit card expires, GitHub will automatically cancel your sponsorship
|
||||||
|
and remove you as a collaborator. Regularly checking your payment method is
|
||||||
|
recommended to avoid unintended cancellations. If it happens, you can
|
||||||
|
reinstate your sponsorship with a new credit card.
|
229
docs/insiders/sponsoring-tiers.md
Normal file
229
docs/insiders/sponsoring-tiers.md
Normal file
@ -0,0 +1,229 @@
|
|||||||
|
# Sponsoring tiers
|
||||||
|
|
||||||
|
We offer a range of sponsoring tiers tailored to the diverse needs of our
|
||||||
|
community. Whether you're an individual user, or rooted in academia, or work in
|
||||||
|
an organization using our software commercially, there's a sponsoring tier
|
||||||
|
that suits your needs.
|
||||||
|
|
||||||
|
## Choosing a tier
|
||||||
|
|
||||||
|
Choosing the right sponsoring tier depends on your needs and how you intend to
|
||||||
|
use Material for MkDocs Insiders. Our tiers are categorized into [non-commercial]
|
||||||
|
and [commercial] use:
|
||||||
|
|
||||||
|
- __Non-commercial tiers__: Intended for individuals, Open Source projects,
|
||||||
|
and academic use
|
||||||
|
- __Commercial tiers__: Designed for organizations and enterprises of any size
|
||||||
|
|
||||||
|
Each [monthly sponsoring tier] offers a range of benefits tailored to your needs.
|
||||||
|
Benefits include access to our private Material for MkDocs Insiders repository,
|
||||||
|
priority handling of bug reports, and more, which vary by the number of
|
||||||
|
projects[^1] that you intend to build with it and collaborators required.
|
||||||
|
Remember, you can always [upgrade or downgrade] your
|
||||||
|
sponsorship level at any time.
|
||||||
|
|
||||||
|
[^1]:
|
||||||
|
A project is defined as a folder with a `mkdocs.yml` configuration file
|
||||||
|
that is built with Material for MkDocs Insiders. This is the only limitation
|
||||||
|
to follow – the number of documentation pages or the size of your project
|
||||||
|
is up to you.
|
||||||
|
|
||||||
|
[monthly sponsoring tier]: #monthly-sponsoring
|
||||||
|
[non-commercial]: #non-commercial-use
|
||||||
|
[commercial]: #commercial-use
|
||||||
|
[upgrade or downgrade]: #switching-tiers
|
||||||
|
|
||||||
|
## Monthly sponsoring
|
||||||
|
|
||||||
|
Monthly sponsoring tiers provide you with access to our private Material for
|
||||||
|
MkDocs Insiders repository. Your financial contribution supports the ongoing
|
||||||
|
development of both the Insiders and the community edition.
|
||||||
|
|
||||||
|
### Non-commercial use
|
||||||
|
|
||||||
|
Non-commercial use essentially means "personal use". This includes individuals
|
||||||
|
using the Insiders edition for personal or purely non-commercial Open Source
|
||||||
|
projects. We offer two different tiers for non-commercial use.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### The Individual
|
||||||
|
|
||||||
|
You love Material for MkDocs and use it for your Open Source project or personal
|
||||||
|
blog. You read about all the awesome features in Insiders, which are first
|
||||||
|
exclusively released to sponsors, and don't want to miss out.
|
||||||
|
|
||||||
|
__Rewards:__
|
||||||
|
|
||||||
|
- :material-door-open: Access to Insiders
|
||||||
|
- :material-charity: Non-commercial use for __1-2 projects__
|
||||||
|
|
||||||
|
[ Sponsor with __$15 a month__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][15 a month]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[15 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### The Dedicated Individual
|
||||||
|
|
||||||
|
You use Material for MkDocs for several of your Open Source projects or personal
|
||||||
|
sites, and just love that you can build beautiful documentation without having
|
||||||
|
to worry about the constantly breaking JavaScript ecosystem – this is now
|
||||||
|
[@squidfunk's] job.
|
||||||
|
|
||||||
|
[@squidfunk's]: https://github.com/squidfunk
|
||||||
|
|
||||||
|
__Rewards:__
|
||||||
|
|
||||||
|
- :material-door-open: Access to Insiders
|
||||||
|
- :material-charity: Non-commercial use for __3+ projects__
|
||||||
|
|
||||||
|
[ Sponsor with __$35 a month__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][35 a month]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[35 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210641
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Commercial use
|
||||||
|
|
||||||
|
Commercial use refers to any use of our software for a business or for-profit
|
||||||
|
purpose. This includes any use by a corporation or other organization, whether
|
||||||
|
or not they generate revenue directly from the software. We offer different
|
||||||
|
pricing tiers for commercial use, each tailored to the needs of different
|
||||||
|
businesses. It's important to note that internal use of the software within your
|
||||||
|
organization is also considered commercial use, as with all commercial software.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### The Organization :star:
|
||||||
|
|
||||||
|
Your organization uses Material for MkDocs for its documentation or internal
|
||||||
|
knowledge base and wants to make sure that it is well-maintained and safe to use
|
||||||
|
for the years to come. You agree that $125 a month (less than 1 hour of a
|
||||||
|
skilled developer) is a clever investment into a solution, solving tons of
|
||||||
|
problems you don't want to fight yourself.
|
||||||
|
|
||||||
|
__Rewards:__
|
||||||
|
|
||||||
|
- :material-door-open: Access to Insiders
|
||||||
|
- :material-currency-usd: Commercial use for __1-9 projects__
|
||||||
|
- :material-run-fast: Your bug reports are __prioritized__
|
||||||
|
- :material-star: Backlink + placement of __small logo__
|
||||||
|
|
||||||
|
[ Sponsor with __$125 a month__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][125 a month]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[125 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210643
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### The Global Organization :star::star:
|
||||||
|
|
||||||
|
Your organization runs many internal and public-facing sites that are built with
|
||||||
|
Material for MkDocs, helping you to share and manage knowledge efficiently.
|
||||||
|
You've evaluated several commercial alternatives which will cost you 3-4x more,
|
||||||
|
some of which with a smaller feature set. You agree that $250 a month (less than
|
||||||
|
2 hours of a skilled developer) is a very good deal for the value you're getting
|
||||||
|
out of it.
|
||||||
|
|
||||||
|
__Rewards:__
|
||||||
|
|
||||||
|
- :material-door-open: Access to Insiders
|
||||||
|
- :material-currency-usd: Commercial use for __10-49 projects__
|
||||||
|
- :material-run-fast: Your bug reports are __prioritized__
|
||||||
|
- :material-star: Backlink + placement of __logo__
|
||||||
|
|
||||||
|
[ Sponsor with __$250 a month__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][250 a month]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[250 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=181282
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### The Holistic Organization :star::star::star:
|
||||||
|
|
||||||
|
Your organization's day-to-day operations critically depend on Material for
|
||||||
|
MkDocs, and you need to make sure that bugs are fixed quickly to keep your
|
||||||
|
customers happy. You see your work as part of a larger ecosystem, realizing that
|
||||||
|
giving back is essential to keeping everything you fight for alive.
|
||||||
|
|
||||||
|
__Rewards:__
|
||||||
|
|
||||||
|
- :material-door-open: Access to Insiders
|
||||||
|
- :material-currency-usd: Commercial use for __50+ projects__
|
||||||
|
- :material-run-fast: Your bug reports are __prioritized__
|
||||||
|
- :material-star: Backlink + placement of __large logo__
|
||||||
|
- :material-face-agent: Private __email support__
|
||||||
|
|
||||||
|
[ Sponsor with __$1,000 a month__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][1000 a month]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[1000 a month]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=334388
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## One-time sponsoring
|
||||||
|
|
||||||
|
For those who wish to contribute one-time without an ongoing subscription and
|
||||||
|
without receiving access to the exclusive Insiders features, we offer the
|
||||||
|
following one-time sponsoring tiers.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Just a Tip! :money_with_wings:
|
||||||
|
|
||||||
|
You asked a question or needed some help on a problem, and we've helped you
|
||||||
|
quickly. You want no perks, just good karma and a warm feeling of giving
|
||||||
|
something back.
|
||||||
|
|
||||||
|
[ Sponsor __$20 one-time__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][20 one-time]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[20 one-time]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=222886
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### The Mentoring
|
||||||
|
|
||||||
|
A 1-hour video call with [@squidfunk], the creator and core maintainer of the
|
||||||
|
project. He is happy to share his experiences with you and help you with
|
||||||
|
anything related to his work.
|
||||||
|
|
||||||
|
__Popular topics are:__
|
||||||
|
|
||||||
|
- How to tailor Material for MkDocs to your needs
|
||||||
|
- How to start earning a living in Open Source
|
||||||
|
- How to make your Open Source project sustainable
|
||||||
|
|
||||||
|
[@squidfunk]: https://github.com/squidfunk
|
||||||
|
|
||||||
|
[ Sponsor __$350 one-time__ <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][350 one-time]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[350 one-time]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210891
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Custom amount
|
||||||
|
|
||||||
|
You're invited to contribute custom sponsorship amounts via GitHub Sponsors,
|
||||||
|
enabling you to support Material for MkDocs according to your preferences.
|
||||||
|
Please be aware that individuals need to pledge a minimum of $15 a month to
|
||||||
|
access Insiders, whereas organizations are encouraged to sponsor $125 a month or
|
||||||
|
more, based on their requirements.
|
||||||
|
|
||||||
|
Contributions exceeding these thresholds are highly appreciated. Please note
|
||||||
|
that one-time donations, regardless of their size, won't be granted access to
|
||||||
|
Insiders due to technical constraints.
|
||||||
|
|
||||||
|
## Switching tiers
|
||||||
|
|
||||||
|
You can easily switch between different sponsorship tiers — [upgrade] or
|
||||||
|
[downgrade] — at any time. Simply visit the @squidfunk's
|
||||||
|
[GitHub Sponsors profile] and adjust your sponsorship tier selection. Once
|
||||||
|
you've made the change, you'll immediately sponsor at the new tier.
|
||||||
|
|
||||||
|
If you exceed the number of projects within your current sponsorship limit, we
|
||||||
|
kindly request that you upgrade your sponsorship to a higher tier to retain
|
||||||
|
access to Material for MkDocs Insiders. The change takes effect immediately,
|
||||||
|
and the amount is prorated based on your [billing cycle].
|
||||||
|
|
||||||
|
[upgrade]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/upgrading-a-sponsorship
|
||||||
|
[downgrade]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/downgrading-a-sponsorship
|
||||||
|
[billing cycle]: https://docs.github.com/en/github/setting-up-and-managing-billing-and-payments-on-github/changing-the-duration-of-your-billing-cycle
|
||||||
|
[GitHub Sponsors profile]: https://github.com/sponsors/squidfunk
|
121
docs/insiders/why-sponsor-us.md
Normal file
121
docs/insiders/why-sponsor-us.md
Normal file
@ -0,0 +1,121 @@
|
|||||||
|
# Why sponsor us
|
||||||
|
|
||||||
|
Material for MkDocs is an Open Source project that is developed and maintained
|
||||||
|
by a small team of individuals who want to devote as much time as possible to
|
||||||
|
make it better every day. We need to rely on the financial support of
|
||||||
|
[our awesome sponsors], who buy us the time to work on it.
|
||||||
|
|
||||||
|
[become a monthly sponsor]: sponsoring-tier.md
|
||||||
|
[our awesome sponsors]: our-sponsors.md
|
||||||
|
[squidfunk's sponsor profile]: https://github.com/sponsors/squidfunk/
|
||||||
|
|
||||||
|
## Who we are
|
||||||
|
|
||||||
|
While [the project was started] by @squidfunk as a personal side project, the
|
||||||
|
[Sponsorware] model that the project adopted in 2020 allowed him to build a
|
||||||
|
small team of amazing individuals around him, [who are now helping him] to
|
||||||
|
maintain the project, as well as the growing list of sponsors.
|
||||||
|
|
||||||
|
[the project was started]: #how-it-started
|
||||||
|
[sponsorware]: #sponsorware
|
||||||
|
[who are now helping him]: #where-we-are-today
|
||||||
|
|
||||||
|
### How it started
|
||||||
|
|
||||||
|
In 2015, albeit 10 years in the industry, @squidfunk was still quite new to
|
||||||
|
Open Source. Having just finished his latest Open Source project, he realized
|
||||||
|
that the project was too complex to be explained in a plain README on GitHub.
|
||||||
|
He needed a good documentation tool for this project.
|
||||||
|
|
||||||
|
After evaluating static site generators in general and Hugo, Sphinx and MkDocs
|
||||||
|
in particular, he quickly decided that MkDocs seemed a good choice, as it was
|
||||||
|
specifically aimed at technical project documentation and easy to use.
|
||||||
|
Unfortunately, all of the available themes looked dated, and since @squidfunk
|
||||||
|
is a very visual person, he just couldn't convince himself to call it a day.
|
||||||
|
|
||||||
|
He needed to build a theme.
|
||||||
|
|
||||||
|
Months later, in February 2016, [the first version] of Material for MkDocs was
|
||||||
|
released. Over the next years, @squidfunk being the sole maintainer, countless
|
||||||
|
feature requests were implemented and bugs were fixed, allowing the project to
|
||||||
|
gain popularity and reach almost 3,000 stars on GitHub by the end of 2019. It
|
||||||
|
is still his most popular project to date.
|
||||||
|
|
||||||
|
As the project grew, @squidfunk started to implement feature requests that made
|
||||||
|
sense from a general perspective, but not for his personal use. This was the
|
||||||
|
point where the project started to shift from a personal project to a
|
||||||
|
community-driven one, and began to feel like a secondary job. Having a primary
|
||||||
|
job, many maintainers burn out when their side projects become successful, which
|
||||||
|
is why @squidfunk decided to give the [Sponsorware] model a try and make
|
||||||
|
Material for MkDocs his primary job. This turned out to be an incredible success.
|
||||||
|
|
||||||
|
[the first version]: https://github.com/squidfunk/mkdocs-material/releases/tag/0.1.0
|
||||||
|
|
||||||
|
### Sponsorware
|
||||||
|
|
||||||
|
The Sponsorware model is simple – as a sponsor, you get early access to the
|
||||||
|
latest and greatest features of Material for MkDocs as part of [Insiders] before
|
||||||
|
everyone else gets to enjoy them, as you are the one making them possible with
|
||||||
|
your financial contributions.
|
||||||
|
|
||||||
|
Every new feature that lands in [Insiders] is linked to a funding goal with a
|
||||||
|
specific amount. Once this amount is reached, all of the features that are part
|
||||||
|
of this funding goal are merged into the community edition, making them
|
||||||
|
available to everyone. It is that simple.
|
||||||
|
|
||||||
|
This brand-new and still experimental approach not only helps keep the project
|
||||||
|
vibrant and cutting-edge but also ensures it can continue to meet and exceed
|
||||||
|
your expectations.
|
||||||
|
|
||||||
|
[Insiders]: index.md
|
||||||
|
|
||||||
|
### Where we are today
|
||||||
|
|
||||||
|
Fast forward to today, Material for MkDocs is a thriving community-supported
|
||||||
|
and well-funded project, with over 500 sponsors and a small but growing team,
|
||||||
|
used by international companies and organizations. The project has outgrown
|
||||||
|
its original purpose by far, as it has become so much more than just a theme –
|
||||||
|
a powerful documentation framework built on top of MkDocs.
|
||||||
|
|
||||||
|
Starting in 2020 with the advent of the [Sponsorware] model, the frequency of
|
||||||
|
releases has more than doubled, with a new release seeing the light of day on
|
||||||
|
average every 1-2 weeks. Moreover, our team responds to issues as fast as
|
||||||
|
possible, keeping the number of open issues low.
|
||||||
|
|
||||||
|
## Our pledge
|
||||||
|
|
||||||
|
We're working hard to make Material for MkDocs one of the best documentation
|
||||||
|
tools out there, ridiculously powerful, a pleasure to use and most importantly –
|
||||||
|
free and Open Source. It is the financial contributions of our awesome sponsors,
|
||||||
|
that allow us to do our best work.
|
||||||
|
|
||||||
|
It's a simple equation: as long as this project is funded, we can continue to
|
||||||
|
improve it, fix bugs, and add new features. We will continue to provide the
|
||||||
|
best possible support to our users and make sure that Material for MkDocs
|
||||||
|
remains a tool that you love to use.
|
||||||
|
|
||||||
|
If you sponsor us, your contribution helps us to pay for:
|
||||||
|
|
||||||
|
1. __Taxes__: Since we provide a service to our sponsors, we're of course
|
||||||
|
legally obligated and happy to pay sales tax. This requirement applies to
|
||||||
|
all sponsorship contributions, aligning us with standard business practices,
|
||||||
|
as for the rest of the world.
|
||||||
|
|
||||||
|
2. __Sponsorships__: A significant portion of our funding is redirected to
|
||||||
|
upstream projects. This cultivates collaboration and supports the broader
|
||||||
|
Open Source ecosystem. We regard those projects and their maintainers as
|
||||||
|
essential for the persistence of Material for MkDocs.
|
||||||
|
|
||||||
|
3. __Team__: Our team is growing! With more funds available, we can pay more
|
||||||
|
individuals to help us make Material for MkDocs even better. Note that this
|
||||||
|
covers various aspects of the project, like the creation of new features,
|
||||||
|
bug resolution, support, and sponsor relations.
|
||||||
|
|
||||||
|
We are bootstrapped – no investors to please! If you decide to support us, you
|
||||||
|
help us stay independent and free from outside influence. This means we can
|
||||||
|
focus on building a solution that you love to use and keep ownership of your
|
||||||
|
documentation project without vendor lock-in.
|
||||||
|
|
||||||
|
[ Choose a sponsoring tier <span class="mdx-sponsorship-count" data-mdx-component="sponsorship-count"></span>][sponsoring-tiers]{ .md-button .md-button--primary .mdx-sponsorship-button }
|
||||||
|
|
||||||
|
[sponsoring-tiers]: sponsoring-tiers.md
|
67
docs/support.md
Normal file
67
docs/support.md
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
# Support
|
||||||
|
|
||||||
|
At the heart of Material for MkDocs is an open and supportive community dedicated
|
||||||
|
to freely sharing knowledge and insights. We strive to offer support to this
|
||||||
|
community, balancing our development efforts with the need to address community
|
||||||
|
questions effectively.
|
||||||
|
|
||||||
|
In order to streamline communication and direct you to the most appropriate
|
||||||
|
support channel, we've outlined our support structure below.
|
||||||
|
|
||||||
|
## Sponsoring support
|
||||||
|
|
||||||
|
If you have questions about Insiders or are considering becoming a sponsor,
|
||||||
|
@katharinalisalin is here to help. She handles all non-technical
|
||||||
|
sponsorship-related inquiries and is happy to provide the guidance you need.
|
||||||
|
Feel free to contact her at sponsors@squidfunk.com.
|
||||||
|
|
||||||
|
## Technical support
|
||||||
|
|
||||||
|
We are committed to providing technical support, ensuring all interactions
|
||||||
|
remain transparent and accessible. Our primary channels for technical inquiries,
|
||||||
|
therefore, are [our discussion board] and [our issue tracker] which are open to
|
||||||
|
the entire community.
|
||||||
|
|
||||||
|
[our discussion board]: #discussion-board
|
||||||
|
[our issue tracker]: #issue-tracker
|
||||||
|
|
||||||
|
|
||||||
|
### Discussion board
|
||||||
|
|
||||||
|
Our [discussion board] serves as the primary point of contact for technical
|
||||||
|
discussions, supported by both our community and our [Community Experts]. We
|
||||||
|
encourage searching the board for existing answers before posting new questions.
|
||||||
|
|
||||||
|
Direct support, particularly for core feature-related queries, is actively
|
||||||
|
provided here, whereas customization tips are often sourced from and shared by
|
||||||
|
our amazing community.
|
||||||
|
|
||||||
|
[Community Experts]: insiders/community-experts-program/index.md
|
||||||
|
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
|
||||||
|
|
||||||
|
### Issue Tracker
|
||||||
|
|
||||||
|
For [reporting bugs] or submitting [change requests], our [issue tracker] offers
|
||||||
|
a transparent platform for community contributions. We encourage reporting bugs
|
||||||
|
found in the Insiders edition and in the community edition with the help of [our
|
||||||
|
contributing guides] through the public [issue tracker], mindful of not
|
||||||
|
disclosing the private Insiders' source code in line with our [fair use
|
||||||
|
policy].
|
||||||
|
|
||||||
|
This transparent approach ensures that solutions can benefit the entire
|
||||||
|
community and feature requests can get upvoted by the community which will
|
||||||
|
affect the speed of its development.
|
||||||
|
|
||||||
|
[reporting bugs]: contributing/reporting-a-bug.md
|
||||||
|
[change requests]: contributing/requesting-a-change.md
|
||||||
|
[our contributing guides]: ./contributing/index.md
|
||||||
|
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
|
||||||
|
[public issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
|
||||||
|
[fair use policy]: ./insiders/license.md/#fair-use-policy
|
||||||
|
|
||||||
|
### Prioritized support
|
||||||
|
|
||||||
|
Organizational sponsors at "The Organization" tier or higher are entitled to
|
||||||
|
prioritized bug support. While we cannot guarantee immediate resolution, as
|
||||||
|
some problems are harder to fix than others, it ensures that your issues are
|
||||||
|
addressed with urgency.
|
14
mkdocs.yml
14
mkdocs.yml
@ -251,8 +251,20 @@ nav:
|
|||||||
- Tooltips: reference/tooltips.md
|
- Tooltips: reference/tooltips.md
|
||||||
- Insiders:
|
- Insiders:
|
||||||
- insiders/index.md
|
- insiders/index.md
|
||||||
|
- Why sponsor us: insiders/why-sponsor-us.md
|
||||||
|
- What's in it for you: insiders/benefits.md
|
||||||
|
- Who is sponsoring: insiders/our-sponsors.md
|
||||||
|
- Sponsoring tiers: insiders/sponsoring-tiers.md
|
||||||
|
- How to sponsor: insiders/how-to-sponsor.md
|
||||||
|
- Additional information:
|
||||||
|
- Payment and billing: insiders/payment-and-billing.md
|
||||||
|
- Access management: insiders/access-management.md
|
||||||
|
- Runtime and cancellation: insiders/runtime-and-cancellation.md
|
||||||
|
- Privacy: insiders/privacy.md
|
||||||
|
- License: insiders/license.md
|
||||||
|
- Support: support.md
|
||||||
|
- Using Insiders:
|
||||||
- Getting started: insiders/getting-started.md
|
- Getting started: insiders/getting-started.md
|
||||||
- FAQ: insiders/faq/sponsoring.md
|
|
||||||
- Changelog:
|
- Changelog:
|
||||||
- insiders/changelog/index.md
|
- insiders/changelog/index.md
|
||||||
- How to upgrade: insiders/upgrade.md
|
- How to upgrade: insiders/upgrade.md
|
||||||
|
Loading…
Reference in New Issue
Block a user