Skip to content

Commit 09e250b

Browse files
committed
Merge branch 'master' of github.com:squidfunk/mkdocs-material
2 parents bafa780 + 17f6edb commit 09e250b

File tree

2 files changed

+133
-0
lines changed

2 files changed

+133
-0
lines changed
Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
# Calling for Community Experts
2+
3+
Interested in joining the Material for MkDocs team as a Community Expert?
4+
We're on the lookout for individuals who are passionate about supporting our
5+
awesome community. In return for your valuable contributions, time, and
6+
insights, you'll gain free access to the Insiders edition.
7+
8+
## Why we need you
9+
10+
As our project and community continue to grow, so do the questions and needs of
11+
our users on our discussion board. Our discussion board is a vital part of our
12+
project, serving as a hub for our community to connect and a valuable knowledge
13+
base to complement our documentation. We're eager to keeping it well-maintained,
14+
organized, easy to search and address all queries which is why we need extra
15+
hands to keep up with the demand. That's where our team of three
16+
(_limited seats_) Community Experts comes in.
17+
18+
## Your role
19+
20+
As a Community Expert, your role primarily involves active participation on
21+
the [discussion board], where you will be:
22+
23+
- Answering discussions to help users with their questions
24+
- Providing guidance regarding implementations
25+
- Sharing insights into customizations and workarounds
26+
- Optimizing searchability by adjusting discussion titles with relevant keywords
27+
28+
## Your benefits
29+
30+
Here is a list of the benefits we offer to our Community Experts:
31+
32+
- __Free access to Material for MkDocs Insiders:__ Exclusive Access to all of
33+
our Material for MkDocs Insiders features for non-commercial use[^1]
34+
- __Close communication with the team:__ Stay connected with us through various
35+
channels, including calls and internal project management tools
36+
- __GitHub profile boost:__ Enhance your GitHub profile's visibility and
37+
credibility as your activity increases, earning you valuable badges that can
38+
enhance your CV
39+
40+
[^1]:
41+
We can only grant access to individuals who are using Material for MkDocs for
42+
non-commercial purposes. This means they are using it for their private or
43+
open-source projects. Please note that the role of a Community Expert
44+
cannot be fulfilled by an organization member seeking access for the entire
45+
organization's benefit.
46+
47+
## Your knowledge & skills
48+
49+
To be a successful Community Expert, your skills should include the
50+
following:
51+
52+
- __Material and MkDocs allrounder:__ You have an understanding of Material for
53+
MkDocs and the MkDocs ecosystem
54+
- __Great communicator:__ You enjoy helping others in a productive and friendly
55+
manner and use a inclusive and welcoming language
56+
- __Independent worker:__ You are self-motivated, stay up-to-date with project
57+
developments, regularly check the discussion board, and respond to notifications
58+
in a reasonable time
59+
60+
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
61+
[documentation]: https://squidfunk.github.io/mkdocs-material/
62+
[contribution guides]: ../contributing/index.md
63+
64+
## Your time commitment
65+
66+
We don't require a fixed number of hours each week; instead, we ask for a
67+
minimum of __five answered discussions per month[^1]__, which amounts to
68+
slightly more than one per week. Your active interaction within the community is
69+
highly valued. To do this effectively, it's best to regularly check the
70+
discussion board to see where you can offer help. The time you invest may vary
71+
depending on the complexity of the topics and questions.
72+
73+
Upon joining, you'll receive access to the Insiders' edition for as long as you
74+
continue to assist us. Access will be renewed every three months, allowing you
75+
the flexibility to continue your contributions or take a break as needed.
76+
77+
[^2]:
78+
An answered discussion is a collaborative interaction where knowledge and
79+
expertise are shared, resulting in resolutions or clarifications that benefit
80+
the user and our entire community. In essence, it embodies the spirit of
81+
cooperation and support within our community, highlighting the power of
82+
collective wisdom and the willingness to assist and uplift one another.
83+
84+
## Ready to get started?
85+
86+
Since we have a limited number of seats for these roles (maximum of three), we
87+
would like to get to know you before you become one of our Community
88+
Experts. Here's how to get started:
89+
90+
### Step 1: Get in touch
91+
92+
Send us an email introducing yourself, sharing a bit about your background, and
93+
include a link to your GitHub profile. Additionally, provide links to three
94+
previous discussions you've answered on the discussion board, where you've
95+
assisted another community member. Please use the following email template to
96+
reach out to us at [email protected]:
97+
98+
```
99+
Subject: Community Expert
100+
101+
Intro
102+
Make a small intro, telling us a bit about yourself.
103+
- Name:
104+
- Background:
105+
- Job:
106+
- GitHub profile:
107+
108+
Answered discussions
109+
- Link 1:
110+
- Link 2:
111+
- Link 3:
112+
```
113+
114+
### Step 2: Evaluation
115+
116+
After receiving and reviewing your email, we will get in touch with you to
117+
discuss everything you need to know to get started. We will set you up as a
118+
collaborator and provide you immediate access to the Insiders edition for three
119+
months.
120+
121+
### Step 3: Dive in
122+
123+
Let's get started! You can actively begin participating in five discussions per
124+
month. We trust you to take the lead, and there's no need for strict monitoring.
125+
Simply ensure that you are consistently listed on the "Most Helpful" list,
126+
located on the discussion board's left side, under the categories.
127+
---
128+
129+
__Ready to join us?__
130+
131+
Sounds good? Let's give it a try!

mkdocs.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -257,5 +257,7 @@ nav:
257257
- Changelog:
258258
- insiders/changelog/index.md
259259
- How to upgrade: insiders/upgrade.md
260+
- Community Experts Program:
261+
- insiders/community-experts-program/index.md
260262
- Blog:
261263
- blog/index.md

0 commit comments

Comments
 (0)