Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: Add maintainers guide section #205

Merged
merged 39 commits into from
Nov 16, 2023
Merged
Changes from 1 commit
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
7bda3f3
Add maintainers guide section
BekahHW Nov 10, 2023
affe87c
Add contrib list pic
BekahHW Nov 13, 2023
5cfbc0d
Add lists section of guide
BekahHW Nov 13, 2023
f3479f8
Add understanding lists data, first draft
BekahHW Nov 13, 2023
8ca5e50
Revise Understanding lists Data for clarity and brevity
BekahHW Nov 14, 2023
96552d4
Remove spaces
BekahHW Nov 14, 2023
a7dfbbd
Add highlights section
BekahHW Nov 14, 2023
a58d50c
Move gifs to gif folder and update in guide
BekahHW Nov 14, 2023
52e9cc5
Add new pages to sidebar
BekahHW Nov 14, 2023
e14464b
Fix name
BekahHW Nov 14, 2023
23feee1
Update item names
BekahHW Nov 14, 2023
7fe77d5
Use the same title as sidebar label
BekahHW Nov 15, 2023
0031807
Link to guide from insights page
BekahHW Nov 15, 2023
961cda3
Add links to maintainers guide in lists page
BekahHW Nov 15, 2023
c637de0
Update lists to include sync your GitHub Team
BekahHW Nov 15, 2023
b84f7f5
Fix spacing and indentation
adiati98 Nov 15, 2023
f408b80
Fix capitalizations and punctuations
adiati98 Nov 15, 2023
ce4b6b2
Fix typo and adjust wordings in maintainers-guide.md
adiati98 Nov 15, 2023
d081c30
Fix typo and adjust wordings in understanding-insights.md
adiati98 Nov 15, 2023
31178df
Fix typo and adjust wordings in understanding-lists-data.md
adiati98 Nov 15, 2023
0f8b12f
Fix broken internal links
adiati98 Nov 15, 2023
daafd7f
Use same title as sidebar label for Understanding Lists Data
adiati98 Nov 15, 2023
bf32b5f
Bold the ways to add a list and minor fix
adiati98 Nov 15, 2023
5ff11c7
Resolve conflicts
adiati98 Nov 16, 2023
5c6a31e
Change link to FAQ with internal link
adiati98 Nov 16, 2023
e683ea5
Add link to extension
BekahHW Nov 16, 2023
41e1544
Clarify default state of lists
BekahHW Nov 16, 2023
eb7cbae
add missing word
BekahHW Nov 16, 2023
6694441
Clarify Highlights tab
BekahHW Nov 16, 2023
4909e42
remove incorrect description of list dashboard
BekahHW Nov 16, 2023
388b4a4
Simplify sentence
BekahHW Nov 16, 2023
259e27c
Clarify languages
BekahHW Nov 16, 2023
ceb87a3
Remove chrome ext reference
BekahHW Nov 16, 2023
be89fcf
Update docs/maintainers/maintainers-guide.md
BekahHW Nov 16, 2023
4f4f5ae
Change word churn to alumni
adiati98 Nov 16, 2023
7cbc20d
Merge branch 'feature/maintainer-guide' of https://github.com/open-sa…
adiati98 Nov 16, 2023
47368d9
Change capital letters to lowercase
adiati98 Nov 16, 2023
3b79831
Change h4 to h3
adiati98 Nov 16, 2023
2fb312e
Change capital letters to lowercase
adiati98 Nov 16, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Fix typo and adjust wordings in understanding-lists-data.md
  • Loading branch information
adiati98 committed Nov 15, 2023
commit 31178df21a7355362dce9cb6330d4b6a8f83fa59
14 changes: 7 additions & 7 deletions docs/maintainers/understanding-lists-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,21 +9,21 @@ keywords:

Once you've created your list of contributors, it's time to understand the data provided. Understanding this data is key to effectively managing your projects and contributors.

## Understanding Lists Contibutor Data
## Understanding Lists Contributor Data

### Interpreting Total Commits in the Last 30 Days

Understanding the commits over the last thirty days helps in gauging the overall activity and productivity of the group.
Understanding the commits over the last 30 days helps in gauging the overall activity and productivity of the group.

High commit volume might indicate a highly active and engaged team. A sudden drop could signal potential issues or a need for additional support or motivation.

### Monitoring Active Contributors

Identifying active contributors helps in recognizing reliable team members and planning future tasks.

Trends in active contributor numbers can indicate the health of the project community and effectiveness of engagement strategies. Notice the ebbs and flows in individual contributors’ activity.
Trends in active contributor numbers can indicate the health of the project community and the effectiveness of engagement strategies. Notice the ebbs and flows in individual contributors’ activity.

A decline in a normally active contributor’s engagement could indicate burnout or dissatisfaction, while a surge in activity might be tied to recent changes or enhancements in the project. Tracking activity levels can help you in managing team burnout, understanding resource needs, and spotting potential issues before they escalate.
A decline in a normally active contributor’s engagement could indicate burnout or dissatisfaction, while a surge in activity might be tied to recent changes or enhancements in the project. Tracking activity levels can help you manage team burnout, understand resource needs, and spot potential issues before they escalate.

### Understanding Types of Contributors

Expand All @@ -35,20 +35,20 @@ An influx of new contributors might be a positive sign of project popularity, su

#### Alumni Contributors

Alumni contributors are contributors who haven't been active in the last thirty days. Identifying contributors who have stopped contributing helps in assessing potential issues or dissatisfaction.
Alumni contributors are contributors who haven't been active in the last 30 days. Identifying contributors who have stopped contributing helps in assessing potential issues or dissatisfaction.

High churn rates could signal deeper problems within the project environment or community management.

#### Most Active Contributors

Identifying key contributors and potential leaders is important for project health and growth. It can help with delegation of responsibilities and recognition of top performers. It can also identify potential mentors for new contributors and help in planning for succession.

If you see that there are a few active contributors who are doing most of the work, it might be a sign that the project needs more support or that the workload needs to be better distributed.
If you see that a few active contributors are doing most of the work, it might be a sign that the project needs more support or that the workload needs to be better distributed.

### Activity Across Other Repositories

Understanding the range of repositories to which contributors in a list have recently contributed shows the broader interests and skills of the community. It reveals contributors' engagement levels and potential specializations, which allows for effective task allocation and identifying mentorship or leadership candidates.

Additionally, it opens paths for potential cross-project collaborations and strategic project planning, aligning the project’s goals with trends and interests in the open source ecosystem.

Understanding the recent history of each contributor's engagement assists in tracking individual contribution patterns and identifying potentially cooling interests as well.
Understanding the recent history of each contributor's engagement assists in tracking individual contribution patterns and identifying potentially cooling interests.