Cool_Tools/mkdocs-material
1
0
Fork 0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2024-11-27 17:00:54 +01:00
Code Issues Releases Wiki Activity

Added sponsoring FAQs

Browse Source
This commit is contained in:
squidfunk 2023-06-29 16:28:58 +02:00
parent bb7811b993
commit e0a25678c4
No known key found for this signature in database
GPG Key ID: 5ED40BC4F9C436DF
3 changed files with 207 additions and 225 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
docs/faq/index.md
View File

@ -1,51 +0,0 @@
# FAQs – Material for MkDocs
In this section, you will find the most frequently asked questions related to
Material for MkDocs. As we maintainers have decided to monetize Material for
MkDocs, to spend more time working on this project, we have divided the project
and its features into two versions with two repositories.
:fontawesome-solid-people-group: __Community version__ – a public
repository that includes all the basic features and is updated once the funding
goals are reached
:fontawesome-solid-people-arrows: __Insiders verion__ – a private
repository exclusively for our Insiders, which contains more exclusive features
## General
__What is the difference between Material for MkDocs and other documentation frameworks?__
Material for MkDocs is a documentation framework built on top of MkDocs, a
popular static site generator. It also offers advanced theming options, a wide range of plugins,
and custom components that make it easy to create professional-looking
documentation sites quickly and efficiently.
[other documentation]: ../alternatives
## Licensing
__Under which license does Material for MkDocs run?__
Material for MkDocs runs under the [MIT License], which means that it is free
for everyone to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the software.
[MIT License]: ../license
## Support
__I have a question. Where do I ask it?__
You can ask your question on our [discussion board]. We are all about building
an open, supportive community where everyone can share their knowledge and
insights. This approach allows us to maintain transparency and ensures all our
users access the same information. We encourage all our users to visit this
[discussion board] or our [issue tracker] to search for previous discussions to
see if their question has been addressed before or address a new discussion.
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues

378
docs/faq/insiders-version.md → docs/faq/sopnsoring.md
View File

@ -1,4 +1,4 @@
# FAQs – Material for MkDocs Insiders # Sponsoring FAQs
Do you have questions about Material for MkDocs Insiders? We do our best to 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 answer all of your questions on this page. If you can't find your question
@ -8,7 +8,7 @@ below, ask it on our [discussion board]!
## General ## General
[__Why is the Insiders edition offered as a subscription model?__](#why-is-the-insiders-edition-offered-as-a-subscription-model){ #why-is-the-insiders-edition-offered-as-a-subscription-model } [__Why is the Insiders edition offered as a subscription model?__](#insiders-subscription){ #insiders-subscription }
Material for MkDocs always was and will be Open Source, available for free to Material for MkDocs always was and will be Open Source, available for free to
individuals and organizations. As the project grew over time, we found that individuals and organizations. As the project grew over time, we found that
@ -21,14 +21,14 @@ greatest features of Material for MkDocs. The subscription-based model of the
Insiders edition allows us to dedicate more time and resources to the project, Insiders edition allows us to dedicate more time and resources to the project,
which benefits all which benefits all
users of Material for MkDocs. Once our funding goals based on monthly users of Material for MkDocs. Once our funding goals based on monthly
subscriptions are hit, the Insiders features of those funding goals are released subscriptions are hit, the Insiders features of those^ funding goals are released
to the community edition, letting everyone benefit from them. to the community edition, letting everyone benefit from them.
Maintaining both the community and Insiders editions is an ongoing process, and Maintaining both the community and Insiders editions is an ongoing process, and
we rely on our sponsors to support us on a monthly basis, which makes this whole we rely on our sponsors to support us on a monthly basis, which makes this whole
project possible. project possible.
[__What features are included in the Insiders edition?__](#what-features-are-included-in-the-insiders-edition){ #what-features-are-included-in-the-insiders-edition } [__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 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 overview of these features on our [Insiders page], which is updated when new
@ -37,7 +37,7 @@ features are added and released.
[Insiders]: ../insiders/index.md [Insiders]: ../insiders/index.md
[Insiders page]: ../insiders/index.md#whats-in-it-for-me [Insiders page]: ../insiders/index.md#whats-in-it-for-me
[__How often is the Insiders edition updated?__](#how-often-is-the-insiders-edition-updated){ #how-often-is-the-insiders-edition-updated } [__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 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 repositories, the community and Insiders edition, are constantly updated with
@ -45,112 +45,133 @@ bug fixes and new features.
## Sponsorship ## Sponsorship
[__Can I sponsor the project without a GitHub account?__](#can-i-sponsor-the-project-without-a-github-account){ #can-i-sponsor-the-project-without-a-github-account } [__Can I sponsor the project without a GitHub account?__](#sponsorship-account){ #sponsorship-account }
Yes. You can support Material for MkDocs by sponsoring us on [Ko-fi], regardless Yes. You can support Material for MkDocs by sponsoring us on [Ko-fi], regardless
of whether you have a GitHub account or not. However, please note that Insiders of whether you have a GitHub account or not. However, please note that Insiders
is provided as a private repository on GitHub. If after sponoring, you'd like to is provided as a private repository on GitHub. If after sponsoring, you'd like to
gain access to the repository, you'll need to have a GitHub individual or bot gain access to the repository, you'll need to have a GitHub individual or bot
account that can be added as a collaborator. If your organization doesn't use account that can be added as a collaborator. If your organization doesn't use
GitHub or/and host its repositories on other platforms, you can mirror the GitHub or/and host its repositories on other platforms, you can mirror the
Insiders repository in your environment once you have access. Insiders repository in your environment once you have access.
[__Which sponsoring tier should I choose?__](#which-sponsoring-tier-should-i-choose){ #which-sponsoring-tier-should-i-choose } [__Which sponsoring tier should I choose?__](#sponsorship-tier){ #sponsorship-tier }
The sponsoring tiers are divided into non-commercial and commercial tiers. If The sponsoring tiers are divided into non-commercial and commercial tiers. If
you are an individual using Material for MkDocs for private or 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, __non-commercial__ Open Source projects, you have two tiers to choose from,
depending on the number of sites you want to build. For organizations using depending on the number of sites you want to build. For companies using
Material for MkDocs, we offer three different __commercial__ tiers, from which Material for MkDocs, we offer three different __commercial__ tiers, from which
you can choose depending on your requirements. you can choose depending on your requirements.
!!! danger "TODO: Link to what is considered commercial use" Also, please read what is considered [commercial use].
[__Why are one-time sponsorships not granted access to Insiders?__](#why-are-one-time-sponsorships-not-granted-access-to-insiders){ #why-are-one-time-sponsorships-not-granted-access-to-insiders } [commercial use]: #commercial-use
Mainly due to technical reasons, that might be lifted in the future. We use [__Why are one-time sponsorships not granted access to Insiders?__](#sponsorship-one-time){ #sponsorship-one-time }
GitHub webhooks to determine our current active sponsors. When you create or
cancel your monthly subscription, GitHub sends events that we use to 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. automatically add and remove collaborators.
Note that [$15] is the minimum amount to be granted access to Insiders. Note that [$15] is the minimum amount to be granted access to Insiders.
[$15]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638 [$15]: https://github.com/sponsors/squidfunk/sponsorships?tier_id=210638
__How is my sponsorship contribution used to support the project?__ [__How is my sponsorship contribution used to support the project?__](#sponsorship-support){ #sponsorship-support }
> Your sponsorship contribution directly supports the development and
maintenance of the project. It allows us to dedicate more time and resources to
enhance the project's features and functionality. The additional funding helps
us prioritize improvements and updates, benefiting Insiders users and the wider
community. We also actively contribute to other upstream projects, fostering
collaboration and giving back to the Open Source ecosystem.
__Are there any limitations on the number of sponsors for a particular tier?__ Your sponsorship contribution directly supports the development and
> No, there are no limitations on the number of sponsors for any tier. You can maintenance of the project, by buying us maintainers time. It allows us to
sponsor the project at any tier regardless of how many other sponsors are dedicate more time and resources to enhance the project's features and
functionality. The additional funding helps us prioritize improvements and
updates, benefiting Insiders users and the wider community. We also actively
contribute to other upstream projects, fostering collaboration and giving
back to the Open Source ecosystem.
[__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. already there.
## Payment & billing ## Payment & billing
__Is there a trial period for the Insiders version?__ [__Is there a trial period for the Insiders edition?__](#insiders-trial){ #insiders-trial }
> No, we do not offer a trial period for the Insiders version. However, our
subscription model offers flexibility, allowing you to cancel your sponsorship 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 anytime. If you decide to cancel, your sponsorship will remain active until
the end of your billing cycle. the end of your billing cycle.
__What payment options do you accept?__ [__What payment options do you accept?__](#insiders-payment){ #insiders-payment }
> We manage all our transactions and sponsorships through [GitHub Sponsors] and
We manage all our transactions and sponsorships through [GitHub Sponsors] and
[Ko-fi]. To become a sponsor of Material for MkDocs on GitHub, visit [Ko-fi]. To become a sponsor of Material for MkDocs on GitHub, visit
[our sponsors' page]. On there, you can choose from five different sponsorship [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, tiers and pay by credit card. Please note that as of the beginning of 2023,
[GitHub no longer supports PayPal] payments. If you wish to pay with Stripe or [GitHub no longer supports PayPal] payments. If you wish to pay with PayPal,
PayPal, you can find a selection of our sponsorship tiers on [Ko-fi]. Both ou can find a selection of our sponsorship tiers on [Ko-fi]. Both platforms
platforms provide you with a payment receipt once your purchase is successful. provide you with a payment receipt once your purchase is successful.
If you're a company and need assistance choosing the right payment method,
please don't hesitate to reach out to sponsors@squidfunk.com.
[Ko-fi]: https://ko-fi.com/squidfunk [Ko-fi]: https://ko-fi.com/squidfunk
[GitHub Sponsors]: https://github.com/sponsors [GitHub Sponsors]: https://github.com/sponsors
[GitHub no longer supports PayPal]: https://github.blog/changelog/2023-01-23-github-sponsors-will-stop-supporting-paypal/ [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/ [our sponsors' page]: https://github.com/sponsors/squidfunk/
__Are discounts available for the Insiders version, such as student discounts?__ [__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/month
for [The Individual] sponsoring tier for non-commercial use.
__Do you offer free access to Insiders for Open Source projects?__ Unfortunately, we are not able to offer any discounts for the Material for
> No, we do not offer free access to our Material for MkDocs Insiders version. 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 We understand that non-profit organizations may have limited budgets and may
need to prioritize their spending on other projects or organizations. It's need to prioritize their spending on other projects or organizations. However,
important to note that Material for MkDocs is maintained by a small team, 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. 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 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. Open Source model. Therefore, Material for MkDocs itself is already free.
> However, we do offer an affordable [The Individual] tier starting at $15/month, 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 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 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. to all new features, benefiting you from our ongoing development efforts.
__Is Insiders free for those who contribute to this project?__ [__Is Insiders free for those who contribute to this project?__](#insiders-contributors){ #insiders-contributors }
> Great question! We can not offer free access to "drive-by" contributors that
Great question! We can not offer free access to "drive-by" contributors that
only fix minor issues like typos or add new languages. These contributions are only fix minor issues like typos or add new languages. These contributions are
always welcome, but as we need to review them, they resolve in a higher time always welcome, but as we need to review them, they result in a higher time
investment from our side and don't compensate for this work. However, as this investment from our side and don't compensate for this work. However, as this
project keeps growing, we always seek for individuals to support us. In return, project keeps growing, we always seek for individuals to support us. In return,
we offer financial compensation or/and Insiders access. If you are interested we offer financial compensation or/and Insiders access. If you are interested
and have experience in the technologies and paradigms underneath, please get in and have experience in the technologies and paradigms listed below, please get
touch with us at sponsors@squidfunk.com: in touch with us at sponsors@squidfunk.com:
> - Deep knowledge of CSS, HTML, TypeScript - Deep knowledge of CSS, HTML, TypeScript
> - Experience with progressive enhancement and responsive design - Experience with progressive enhancement and responsive design
> - Experience with reactive programming with RxJS - Experience with reactive programming with RxJS
> - Solid understanding of Python, MkDocs + ecosystem - Solid understanding of Python, MkDocs + ecosystem
> - Solid technical writing skills - Solid technical writing skills
__How can I set my billing to monthly or yearly?__ Additionally, we're working on a contributor program that will reward
> You can sponsor Material for MkDocs on a monthly or yearly basis. Depending on contributors that engage in the community by answering questions and helping
users with access to Insiders.
[__How can I set my billing to monthly or yearly?__](#insiders-billing-cycle){ #insiders-billing-cycle }
You can sponsor Material for MkDocs on a monthly or yearly basis. Depending on
your billing cycle you automatically become a monthly or yearly sponsor. Your your billing cycle you automatically become a monthly or yearly sponsor. Your
[billing cycle] is an account-level setting that you can easily change in your [billing cycle] is an account-level setting that you can easily change in your
account. If, for some reason, you cannot make this change, you can create a account. If, for some reason, you cannot make this change, you can create a
@ -160,37 +181,33 @@ further questions, please contact us at 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 [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?__ [__Can I get an invoice for my sponsorship payment?__](#insiders-invoice){ #insiders-invoice}
> Unfortunately, we can't provide you with an invoice for your sponsoring
transaction, as [GitHub Sponsors] handles all transactions for us. However, both Right now, we can't provide you with an invoice for your sponsoring transaction,
payment platforms, [GitHub] and [Ko-Fi], automatically send you a payment receipt as [GitHub Sponsors] handles all transactions for us. However, both payment
via mail once the sponsorship is active. Furthermore, we are working on a platforms, [GitHub] and [Ko-Fi], automatically send you a payment receipt
solution to optimize access management and more features. If you are interested via mail once the sponsorship is active.
in using this solution, please get in touch with us via mail at
sponsors@squidfunk.com or turn on all notifications for MkDocs, and we will Furthermore, we are working on a solution to optimize access management and more
features. If you are interested in this, please get in touch with us via mail at
sponsors@squidfunk.com or turn on all notifications for MkDocs, and we will
reach out as soon as we are live. reach out as soon as we are live.
[GitHub]: https://github.com/sponsors/squidfunk/ [GitHub]: https://github.com/sponsors/squidfunk/
__Can I switch between different sponsoring tiers?__ [__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
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 to the [GitHub Sponsors] page and change your sponsoring tier. Once you make
that change, it will be activated with your next billing cycle. that change, you will immediately change to the new tier.
__How can I renew my sponsorship when it expires?__ If you change to a higher tier, the amount will be prorated according to your
> Renewing your sponsorship is a simple and straightforward process. When your billing cycle.
sponsorship period expires or gets canceled for some reason, you can easily
renew it by visiting [our sponsoring page]. From there, you can choose your
desired sponsoring tier and proceed to re-sponsor the project. Your continued
support is greatly appreciated, and we will make it as convenient as possible
for you to renew your sponsorship and continue contributing to the project's
success.
[our sponsoring page]: https://github.com/sponsors/squidfunk?metadata_origin=docs [__Can I sponsor the project for a specific feature or development goal?__](#insiders-goals){ #insiders-goals }
__Can I sponsor the project for a specific feature or development goal?__ While sponsoring specific goals directly is not possible, our sponsoring goals
> While sponsoring specific goals directly may not be possible, our sponsoring are connected to specific features or development goals aligned with the
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 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 associated features on our website. Insider users have early access to all
already developed features, including those associated with higher funding goals already developed features, including those associated with higher funding goals
@ -202,40 +219,45 @@ that you would like to see on the list, we encourage you to
[overview of these sponsoring goals]: ../insiders/index.md#goals [overview of these sponsoring goals]: ../insiders/index.md#goals
[initiate a new discussion]: https://github.com/squidfunk/mkdocs-material/discussions/new/chooses [initiate a new discussion]: https://github.com/squidfunk/mkdocs-material/discussions/new/chooses
__What happens if I reach my sponsoring limit for my current tier?__ [__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,
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 please [upgrade your sponsorship] to a higher tier to continue using the
Insiders version and build more sites. Insiders version 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 [upgrade your sponsorship]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/upgrading-a-sponsorship
__Do you offer refunds for sponsoring payments?__ [__Do you offer refunds for sponsoring payments?__](#insiders-refunds){ #insiders-refunds }
> Unfortunately, we cannot offer any refund for sponsorship payments.
Unfortunately, we cannot offer any refund for sponsorship payments.
[GitHub Sponsors] and [Ko-Fi] manage all sponsoring transactions. Because of [GitHub Sponsors] and [Ko-Fi] manage all sponsoring transactions. Because of
that, we do not have any insights into the details of the funds and cannot access 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 them. If you have any payment issues, please get in touch with the GitHub
or Ko-Fi support team, as they can help you. or Ko-Fi support team, as they can help you.
## Access management ## Access management
__How do I gain access to the private Insiders repository?__ [__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
If you sponsored with your __individual account__, you should have received an
email invitation to the private Material for MkDocs Insiders repository right email invitation to the private Material for MkDocs Insiders repository right
after you initiated your sponsorship. Simply accept the invitation within seven after you initiated your sponsorship. Simply accept the invitation within seven
days to gain access. days to gain access.
> If you sponsored using an __organization account__, please note we need 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 an individual account that we can list as a collaborator of the private Insiders
repository. After you initiate your sponsorship, please email us at repository. After you initiate your sponsorship, please email us at
sponsors@squidfunk.com with the name of the individual or bot account. Once you 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 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 after you accept the invitation, you will gain access to the repository.
you have yet to receive the email or the invitation link has expired, please
contact us, the maintainers, at sponsors@squidfunk.com.
__Why can't my organizational account get access to Insiders?__ If you have yet to receive the email or the invitation link has expired, please
> Currently, it is not possible to grant access to an organizational account, as 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 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 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 access is not tied to a particular individual, we recommend creating a bot
@ -243,16 +265,18 @@ 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 but is listed as the owner of the organizational account and using this account
for sponsorship. for sponsorship.
__Do I need to fork the repository to use it?__ [__Do I need to fork the repository to use it?__](#access-fork){ #access-fork }
> The answer is both no and yes. If you are using the Insiders version as an
individual, you can work directly with the private repository, as you do not
need to share the Insider 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 and grant access to all members of your
organization to your fork.
__Can I share my Insiders access with others?__ It depends. If you are using the Insiders edition as an individual, you can work
> At the moment, it is not possible to directly share your collaborator status 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 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 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 Insiders repository by utilizing options such as [cloning], [forking], or
@ -267,78 +291,80 @@ from the Insiders features and work together on the project.
## Runtime & cancellation ## Runtime & cancellation
__How long is my sponsorship valid?__ [__How long is my sponsorship valid?__](#sponsorship-runtime){ #sponsorship-runtime }
> Your sponsorship is valid for as long as you continue to pay the monthly or
yearly fee. If you choose to cancel your sponsorship, you will lose access to Your sponsorship is valid for as long as your monthly or yearly subscription
the Insiders version once your cancelation is active and will be automatically is valid. If you choose to cancel your sponsorship, you will lose access to
the Insiders edition once your cancelation is active and will be automatically
removed by GitHub as a collaborator from the private repository. removed by GitHub as a collaborator from the private repository.
__How do I cancel my sponsorship?__ [__How do I cancel my sponsorship?__](#sponsorship-cancellation){ #sponsorship-cancellation }
> To cancel your sponsorship, follow the [step-by-step guide] provided by GitHub.
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 If you sponsored using an organizational account, please ensure that you cancel
your sponsorship using the same organizational account rather than your your sponsorship using the same organizational account rather than your
individual account. This will help ensure that the cancellation is processed individual account.
correctly.
[step-by-step guide]: https://docs.github.com/en/billing/managing-billing-for-github-sponsors/downgrading-a-sponsorship [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?__ [__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 cancelation is 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, 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 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 you at the time of your cancellation for as long as you like.
[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. 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 [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 ## Licensing
__What constitutes commercial use of the Insiders version?__ [__What constitutes commercial use of the Insiders version?__](#commercial-use){ #commercial-use }
> Commercial use refers to any use of the software for a business or for-profit
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 purpose. This includes any use by a corporation or other organization, whether
or not they generate revenue directly from the software. We offer different or not they generate revenue directly from the software. We offer different
pricing tiers for commercial use, each tailored to the needs of 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 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. organization is also considered commercial use, as with all commercial software.
__What constitutes non-commercial use of the Insiders version?__ [__What constitutes non-commercial use of the Insiders version?__](#non-commercial-use){ #non-commercial-use }
> Non-commercial use of our Material for MkDocs refers to any use private use.
This includes individuals using the Insiders version for private or purely Non-commercial use of our Material for MkDocs refers to private use. This
non-commercial Open Source projects. We offer two different tiers for 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. non-commercial use, depending on the number of sites you want to build.
__What is your fair use policy?__ [__What is your fair use policy?__](#fair-use-policy){ #fair-use-policy }
> Our sponsoring approach only works when everybody sticks to our fair use
policy. This fair use policy helps us ensure that our software is used to
benefit both our users and our team. Our policy includes the following
guidelines:
> - Please refrain from __distributing the source code__ of Insiders. While you 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 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 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 is important to our sponsorware strategy, which helps us fund ongoing
development and support of the software. If it is leaked to the public and free development and support of the software. If this guidelines is violated,
for everybody to use, it will destroy our sponsoring approach and massively everybody loses, as it will reduce the time of us maintainers we can set aside
reduce the time we maintainers work on it. Depending on the impact, it might to push this project forward.
lead to serious consequences.
> - As our sponsoring tiers are based on the number of sites you want to build, - 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 please make sure to [upgrade your sponsorship] once your current sponsoring tier
limit has been reached. limit has been reached.
__Does the Insiders version have a different license?__ [__Does the Insiders version have a different license?__](#insiders-license){ #insiders-license }
> No. Whether you're an individual or a company, you may use Material for
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 MkDocs Insiders precisely under the same terms as Material for MkDocs, which are
given by the [MIT license]. given by the [MIT license].
[MIT license]: ../license.md [MIT license]: ../license.md
__Can outside collaborators build and run the documentation locally without access to Insiders?__ [__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
Yes. Insiders is compatible with Material for MkDocs. Almost all new features
and configuration options are either backward-compatible or implemented behind and configuration options are either backward-compatible or implemented behind
feature flags. When working with outside collaborators, changing the general feature flags. When working with outside collaborators, changing the general
appearance of your site should be optional. Most Insiders features enhance the appearance of your site should be optional. Most Insiders features enhance the
@ -348,12 +374,13 @@ optional for previewing when making changes to content. Currently, the only
content-related features in Insiders that non-Insiders users can't properly content-related features in Insiders that non-Insiders users can't properly
preview are [Annotations] and [Card grids]. preview are [Annotations] and [Card grids].
> This means that outside collaborators can build the documentation locally with This means that outside collaborators can build the documentation locally with
Material for MkDocs, and when they push their changes, your CI pipeline will 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 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 recommended to split configuration into a base `mkdocs.yml` and one with plugin
overrides via [configuration inheritance]. See the [getting started guide] for overrides via [configuration inheritance].
more information.
See the [getting started guide] for more information.
[configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance [configuration inheritance]: https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance
[getting started guide]: ../insiders/getting-started.md#caveats [getting started guide]: ../insiders/getting-started.md#caveats
@ -363,16 +390,19 @@ more information.
## Support ## Support
__How can I contact support if I have questions about becoming a sponsor?__ [__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
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 sponsorship, we are happy to answer all your non-technical questions about the
Insiders program via email at sponsors@squidfunk.com. All other questions can be Insiders program via email at sponsors@squidfunk.com.
asked openly on our [discussion board].
All technical questions should be asked openly on our [discussion board].
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions [discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
__Is additional support available for Material for MkDocs Insiders users?__ [__Is additional support available for Material for MkDocs Insiders users?__](#support-additional){ #support-additional }
> Yes, we provide non-technical support related to sponsoring via email at
Yes, we provide non-technical support related to sponsoring at
sponsors@squidfunk.com. For technical questions, please submit an issue openly sponsors@squidfunk.com. For technical questions, please submit an issue openly
on our [issue tracker] or start a discussion on our [discussion board]. Issues on our [issue tracker] or start a discussion on our [discussion board]. Issues
and discussions from our organizational sponsors, sponsoring on and discussions from our organizational sponsors, sponsoring on
@ -386,20 +416,25 @@ __The Organization__ tier or higher will be prioritized.[^1]
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues [issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
__How can I display my logo on the list of premium sponsors?__ [__How can I display my logo on the list of premium sponsors?__](#sponsorship-logo-placement){ #sponsorship-logo-placement }
> If 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 If your sponsorship tier includes logo placement, and you would like us to
vertical SVG or PNG version of your logo making sure it displays the name of display your logo in the [list of premium sponsors] and have it linked to your
your company and the logo to sponsors@squidfunk.com. 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 [list of premium sponsors]: https://github.com/squidfunk/mkdocs-material#user-content-premium-sponsors
__Is logo placement optional?__ [__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.
__How can I report a bug in the Insiders version?__ Yes, all of our commercial benefits, such as logo placement and backlinks, are
> If you encounter a bug in the Insiders edition, we kindly request that you 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 version?__](#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 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 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. Insiders' source code, as we want to uphold our fair use policy.
@ -407,13 +442,15 @@ Insiders' source code, as we want to uphold our fair use policy.
## Privacy ## Privacy
__Will you sign an NDA?__ [__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 any agreement. If you do not wish to
__Can I sponsor privately?__ Unfortunately, we cannot sign any NDA or vendor agreement form. As a small team
> Yes, you can. GitHub gives you the option to set your sponsorship to [private] working on Material for MkDocs, we have limited resources and cannot review
and sign agreements.
[__Can I sponsor privately?__](#sponsorship-private){ #sponsorship-private }
Yes, you can. GitHub gives you the option to set your sponsorship to [private]
when you set up your sponsorship. Additionally, we have a recommended workflow when you set up your sponsorship. Additionally, we have a recommended workflow
for you: We suggest you create a new GitHub bot account. This bot account should for you: We suggest you create a new GitHub bot account. This bot account should
not be tied to a particular individual and should be privately listed as an not be tied to a particular individual and should be privately listed as an
@ -423,14 +460,11 @@ as a collaborator of the private Insiders repository. You can clone, fork, or
mirror using this account. All information will be kept confidential; only the mirror using this account. All information will be kept confidential; only the
bot account and us maintainers will have insights into his sponsorship. bot account and us maintainers will have insights into his sponsorship.
[private]: https://docs.github.com/en/sponsors/sponsoring-Open Source-contributors/managing-your-sponsorship#managing-the-privacy-setting-for-your-sponsorship [private]: https://docs.github.com/en/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship#managing-the-privacy-setting-for-your-sponsorship
__Are there any geographical restrictions on becoming a sponsor?__ [__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
No, there are no geographical restrictions for becoming a sponsor. We welcome
sponsorships from individuals and organizations worldwide. As long as your sponsorships from individuals and organizations worldwide. As long as your
credit card is valid and accepted by GitHub or Ko-Fi, you are eligible to become credit card is valid and accepted by GitHub or Ko-Fi, you are eligible to become
a sponsor and support the project, regardless of your location. a sponsor and support the project, regardless of your location.

3
mkdocs.yml
View File

@ -179,8 +179,7 @@ nav:
- Guides: - Guides:
- Creating a reproduction: guides/creating-a-reproduction.md - Creating a reproduction: guides/creating-a-reproduction.md
- FAQ: - FAQ:
- faq/index.md - Sponsoring: faq/sponsoring.md
- FAQ Sponsoring: faq/insiders-version.md
- Setup: - Setup:
- setup/index.md - setup/index.md
- Changing the colors: setup/changing-the-colors.md - Changing the colors: setup/changing-the-colors.md