Documentation

This commit is contained in:
squidfunk 2023-11-19 11:57:39 +01:00
parent 09e250b03b
commit 258e1dfcd3
No known key found for this signature in database
GPG Key ID: 5ED40BC4F9C436DF

View File

@ -1,24 +1,31 @@
---
title: Community Experts Program
status: new
---
# Calling for Community Experts # Calling for Community Experts
Interested in joining the Material for MkDocs team as a Community Expert? Interested in joining the Material for MkDocs team as a Community Expert?
We're on the lookout for individuals who are passionate about supporting our We're on the lookout for individuals who are passionate about supporting our
awesome community. In return for your valuable contributions, time, and awesome community. In return for your valuable contributions, time, and
insights, you'll gain free access to the Insiders edition. insights, __you'll gain free access to the Insiders edition__.
## Why we need you ## Why we need you
As our project and community continue to grow, so do the questions and needs of As our project and community continue to grow, so do the questions and needs of
our users on our discussion board. Our discussion board is a vital part of our our users on our discussion board. Our discussion board is a vital part of our
project, serving as a hub for our community to connect and a valuable knowledge project, serving as a hub for our community to connect and a valuable knowledge
base to complement our documentation. We're eager to keeping it well-maintained, base to complement our documentation.
organized, easy to search and address all queries which is why we need extra
hands to keep up with the demand. That's where our team of three We're eager to keeping it well-maintained, organized, easy to search and address
(_limited seats_) Community Experts comes in. all queries which is why we need extra hands to keep up with the demand.
That's why we're bulding a team of Community Experts!
## Your role ## Your role
As a Community Expert, your role primarily involves active participation on As a Community Expert, your role primarily involves active participation on
the [discussion board], where you will be: the [discussion board], where we'd expect you to be:
- Answering discussions to help users with their questions - Answering discussions to help users with their questions
- Providing guidance regarding implementations - Providing guidance regarding implementations
@ -29,33 +36,38 @@ the [discussion board], where you will be:
Here is a list of the benefits we offer to our Community Experts: Here is a list of the benefits we offer to our Community Experts:
- __Free access to Material for MkDocs Insiders:__ Exclusive Access to all of - __Free access to Material for MkDocs Insiders__ Exclusive Access to all of
our Material for MkDocs Insiders features for non-commercial use[^1] our Material for MkDocs Insiders features for _non-commercial use_.[^1]
- __Close communication with the team:__ Stay connected with us through various
channels, including calls and internal project management tools - __Close communication with the team__ Stay connected with us through various
- __GitHub profile boost:__ Enhance your GitHub profile's visibility and channels, including calls and internal project management tools.
credibility as your activity increases, earning you valuable badges that can
enhance your CV - __GitHub profile boost__ Enhance your GitHub profile's visibility and
credibility as your activity increases, earning you valuable badges that can
enhance your credibility.
[^1]: [^1]:
We can only grant access to individuals who are using Material for MkDocs for We can only grant access to individuals who are using Material for MkDocs
non-commercial purposes. This means they are using it for their private or for non-commercial purposes. This means they are using it for their private
open-source projects. Please note that the role of a Community Expert or Open Source projects. Please note that the role of a Community Expert
cannot be fulfilled by an organization member seeking access for the entire cannot be fulfilled by an organization member seeking access for the entire
organization's benefit. organization's benefit.
## Your knowledge & skills ## Your knowledge & skills
To be a successful Community Expert, your skills should include the To be a successful Community Expert, your skills should include the
following: following:
- __Material and MkDocs allrounder:__ You have an understanding of Material for - __Material and MkDocs allrounder__ You have an understanding of Material
MkDocs and the MkDocs ecosystem for MkDocs and the MkDocs ecosystem, including many of its extensions and
- __Great communicator:__ You enjoy helping others in a productive and friendly plugins.
manner and use a inclusive and welcoming language
- __Independent worker:__ You are self-motivated, stay up-to-date with project - __Great communicator__ You enjoy helping others in a productive,
developments, regularly check the discussion board, and respond to notifications constructive and friendly manner and use inclusive and welcoming language.
in a reasonable time
- __Independent worker__ You are self-motivated, stay up-to-date with
project developments, regularly check the discussion board, and respond to
notifications in reasonable time.
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions [discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
[documentation]: https://squidfunk.github.io/mkdocs-material/ [documentation]: https://squidfunk.github.io/mkdocs-material/
@ -64,66 +76,74 @@ in a reasonable time
## Your time commitment ## Your time commitment
We don't require a fixed number of hours each week; instead, we ask for a We don't require a fixed number of hours each week; instead, we ask for a
minimum of __five answered discussions per month[^1]__, which amounts to minimum of __five answered discussions per month[^2]__, which amounts to
slightly more than one per week. Your active interaction within the community is slightly more than one per week. Your active interaction within the community is
highly valued. To do this effectively, it's best to regularly check the highly valued.
discussion board to see where you can offer help. The time you invest may vary
depending on the complexity of the topics and questions. To do this effectively, it's best to regularly check the discussion board to see
where you can offer help. The time you invest may vary depending on the
complexity of the topics and questions.
Upon joining, you'll receive access to the Insiders' edition for as long as you Upon joining, you'll receive access to the Insiders' edition for as long as you
continue to assist us. Access will be renewed every three months, allowing you continue to assist us. Access will be renewed every three months, allowing you
the flexibility to continue your contributions or take a break as needed. the flexibility to continue your contributions or take a break as needed.
[^2]: [^2]:
An answered discussion is a collaborative interaction where knowledge and An answered discussion is a collaborative interaction where knowledge and
expertise are shared, resulting in resolutions or clarifications that benefit expertise are shared, resulting in resolutions or clarifications that benefit
the user and our entire community. In essence, it embodies the spirit of the user and our entire community. In essence, it embodies the spirit of
cooperation and support within our community, highlighting the power of cooperation and support within our community, highlighting the power of
collective wisdom and the willingness to assist and uplift one another. collective wisdom and the willingness to assist and uplift one another.
## Ready to get started? ## Ready to get started?
Since we have a limited number of seats for these roles (maximum of three), we Since we have a limited number of seats for these roles[^3], we would like to
would like to get to know you before you become one of our Community get to know you before you become one of our Community Experts. Here's how to
Experts. Here's how to get started: get started:
[^3]:
Please note that we're currently limiting the number of seats on the
Community Experts program to three. We will update this page when we'll
expand the team, which is when we'll be accepting new applications.
### Step 1: Get in touch ### Step 1: Get in touch
Send us an email introducing yourself, sharing a bit about your background, and Send us an email introducing yourself, sharing a bit about your background, and
include a link to your GitHub profile. Additionally, provide links to three include a link to your GitHub profile. Additionally, provide links to three
previous discussions you've answered on the discussion board, where you've previous discussions you've answered on the discussion board, where you've
assisted another community member. Please use the following email template to assisted another community member.
reach out to us at contact@squidfunk.com:
Please use the following email template to reach out to us at
community@squidfunk.com:
``` ```
Subject: Community Expert Subject: Community Expert
Intro Intro: Tell us a bit about yourself.
Make a small intro, telling us a bit about yourself. - Name:
- Name: - Background:
- Background: - Profession:
- Job: - GitHub profile:
- GitHub profile:
Answered discussions Answered discussions
- Link 1: - Link 1:
- Link 2: - Link 2:
- Link 3: - Link 3:
``` ```
### Step 2: Evaluation ### Step 2: Evaluation
After receiving and reviewing your email, we will get in touch with you to After receiving and reviewing your application, we will get in touch with you
discuss everything you need to know to get started. We will set you up as a to discuss everything you need to know to get started. If you get selected, we
collaborator and provide you immediate access to the Insiders edition for three will set you up as a collaborator and provide you immediate access to the
months. Insiders edition for three months.
### Step 3: Dive in ### Step 3: Dive in
Let's get started! You can actively begin participating in five discussions per Let's get started! You can actively begin participating in five discussions per
month. We trust you to take the lead, and there's no need for strict monitoring. month. We trust you to take the lead, and we won't do strict monitoring. Simply
Simply ensure that you are consistently listed on the "Most Helpful" list, ensure that you are consistently listed on the _Most Helpful_ list, located on
located on the discussion board's left side, under the categories. the discussion board's left side, under the categories.
--- ---
__Ready to join us?__ __Ready to join us?__