Skip to content

Commit 258e1df

Browse files
committed
Documentation
1 parent 09e250b commit 258e1df

File tree

1 file changed

+75
-55
lines changed
  • docs/insiders/community-experts-program

1 file changed

+75
-55
lines changed

docs/insiders/community-experts-program/index.md

Lines changed: 75 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,31 @@
1+
---
2+
title: Community Experts Program
3+
status: new
4+
---
5+
16
# Calling for Community Experts
27

38
Interested in joining the Material for MkDocs team as a Community Expert?
49
We're on the lookout for individuals who are passionate about supporting our
510
awesome community. In return for your valuable contributions, time, and
6-
insights, you'll gain free access to the Insiders edition.
11+
insights, __you'll gain free access to the Insiders edition__.
712

813
## Why we need you
914

1015
As our project and community continue to grow, so do the questions and needs of
1116
our users on our discussion board. Our discussion board is a vital part of our
1217
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.
18+
base to complement our documentation.
19+
20+
We're eager to keeping it well-maintained, organized, easy to search and address
21+
all queries which is why we need extra hands to keep up with the demand.
22+
23+
That's why we're bulding a team of Community Experts!
1724

1825
## Your role
1926

2027
As a Community Expert, your role primarily involves active participation on
21-
the [discussion board], where you will be:
28+
the [discussion board], where we'd expect you to be:
2229

2330
- Answering discussions to help users with their questions
2431
- Providing guidance regarding implementations
@@ -29,33 +36,38 @@ the [discussion board], where you will be:
2936

3037
Here is a list of the benefits we offer to our Community Experts:
3138

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+
- __Free access to Material for MkDocs Insiders__ – Exclusive Access to all of
40+
our Material for MkDocs Insiders features for _non-commercial use_.[^1]
41+
42+
- __Close communication with the team__ – Stay connected with us through various
43+
channels, including calls and internal project management tools.
44+
45+
- __GitHub profile boost__ – Enhance your GitHub profile's visibility and
46+
credibility as your activity increases, earning you valuable badges that can
47+
enhance your credibility.
3948

4049
[^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.
50+
We can only grant access to individuals who are using Material for MkDocs
51+
for non-commercial purposes. This means they are using it for their private
52+
or Open Source projects. Please note that the role of a Community Expert
53+
cannot be fulfilled by an organization member seeking access for the entire
54+
organization's benefit.
4655

4756
## Your knowledge & skills
4857

4958
To be a successful Community Expert, your skills should include the
5059
following:
5160

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
61+
- __Material and MkDocs allrounder__ – You have an understanding of Material
62+
for MkDocs and the MkDocs ecosystem, including many of its extensions and
63+
plugins.
64+
65+
- __Great communicator__ – You enjoy helping others in a productive,
66+
constructive and friendly manner and use inclusive and welcoming language.
67+
68+
- __Independent worker__ – You are self-motivated, stay up-to-date with
69+
project developments, regularly check the discussion board, and respond to
70+
notifications in reasonable time.
5971

6072
[discussion board]: https://github.com/squidfunk/mkdocs-material/discussions
6173
[documentation]: https://squidfunk.github.io/mkdocs-material/
@@ -64,66 +76,74 @@ in a reasonable time
6476
## Your time commitment
6577

6678
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
79+
minimum of __five answered discussions per month[^2]__, which amounts to
6880
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.
81+
highly valued.
82+
83+
To do this effectively, it's best to regularly check the discussion board to see
84+
where you can offer help. The time you invest may vary depending on the
85+
complexity of the topics and questions.
7286

7387
Upon joining, you'll receive access to the Insiders' edition for as long as you
7488
continue to assist us. Access will be renewed every three months, allowing you
7589
the flexibility to continue your contributions or take a break as needed.
7690

7791
[^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.
92+
An answered discussion is a collaborative interaction where knowledge and
93+
expertise are shared, resulting in resolutions or clarifications that benefit
94+
the user and our entire community. In essence, it embodies the spirit of
95+
cooperation and support within our community, highlighting the power of
96+
collective wisdom and the willingness to assist and uplift one another.
8397

8498
## Ready to get started?
8599

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:
100+
Since we have a limited number of seats for these roles[^3], we would like to
101+
get to know you before you become one of our Community Experts. Here's how to
102+
get started:
103+
104+
[^3]:
105+
Please note that we're currently limiting the number of seats on the
106+
Community Experts program to three. We will update this page when we'll
107+
expand the team, which is when we'll be accepting new applications.
89108

90109
### Step 1: Get in touch
91110

92111
Send us an email introducing yourself, sharing a bit about your background, and
93112
include a link to your GitHub profile. Additionally, provide links to three
94113
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]:
114+
assisted another community member.
115+
116+
Please use the following email template to reach out to us at
117+
97118

98119
```
99120
Subject: Community Expert
100121
101-
Intro
102-
Make a small intro, telling us a bit about yourself.
103-
- Name:
104-
- Background:
105-
- Job:
106-
- GitHub profile:
122+
Intro: Tell us a bit about yourself.
123+
- Name:
124+
- Background:
125+
- Profession:
126+
- GitHub profile:
107127
108128
Answered discussions
109-
- Link 1:
110-
- Link 2:
111-
- Link 3:
129+
- Link 1:
130+
- Link 2:
131+
- Link 3:
112132
```
113133

114134
### Step 2: Evaluation
115135

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.
136+
After receiving and reviewing your application, we will get in touch with you
137+
to discuss everything you need to know to get started. If you get selected, we
138+
will set you up as a collaborator and provide you immediate access to the
139+
Insiders edition for three months.
120140

121141
### Step 3: Dive in
122142

123143
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.
144+
month. We trust you to take the lead, and we won't do strict monitoring. Simply
145+
ensure that you are consistently listed on the _Most Helpful_ list, located on
146+
the discussion board's left side, under the categories.
127147
---
128148

129149
__Ready to join us?__

0 commit comments

Comments
 (0)