Skip to content

Commit 8809931

Browse files
fellyphakirk
andauthored
[Docs] Adding table lead guide documentation (#2708)
## Motivation for the change, related issues This pull request adds a new documentation page that serves as a guide for table leads at WordCamp Contributor Day events, specifically focusing on managing a WordPress Playground contributor table. The guide covers preparation, onboarding, contribution management, and post-event follow-up. --------- Co-authored-by: Alex Kirk <[email protected]>
1 parent 8e9ff73 commit 8809931

File tree

1 file changed

+78
-0
lines changed

1 file changed

+78
-0
lines changed
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
slug: /contributing/table-lead-guide
3+
title: Table Lead Guide for Contributor Day
4+
description: How to lead a WordPress Playground table at Contributor Day of a WordCamp.
5+
---
6+
7+
# Table Lead Guide for Contributor Day
8+
9+
This guide helps table leads prepare for and manage a WordPress Playground contributor table at WordCamp events.
10+
11+
## Before Contributor Day
12+
13+
### Pre-Work Checklist
14+
15+
- **Curate "Good First Issues"**: Review and update the [good first issues list](https://github.com/WordPress/wordpress-playground/labels/good%20first%20issue) on GitHub. These should be straightforward tasks that new contributors can complete independently. If you find a bug that is not on the list but could be part of it, contact the playground team at the Slack channel.
16+
- **Coordinate with the Playground Team**: Confirm if Playground team members are available online to provide remote support during the event, especially for flagship WordCamps. Due to timezone differences, align in advance at the #playground channel to check their availability.
17+
- **Connect with Local Contributors**: Identify regular contributors in the region attending the event. Check on the #playground Slack Channel if an active community member is participating in the contributor day. This is an opportunity to gather feedback and strengthen community connections.
18+
- **Check the Playground Repository**: If you never contribute with the WordPress Playground Repository, you should get familiar with this a good section at the documentation that can guide you to understand the project is [Developers > Architecture](/developers/architecture) it will contain information how the project is organized. If you have any questions, please get in touch with the team at the Playground Slack channel.
19+
20+
## Starting the Day
21+
22+
### Setup and Onboarding
23+
24+
1. **Create Your Agenda**: Prepare a flexible checklist of key activities while allowing for organic collaboration. Share it in the project documentation if helpful.
25+
26+
2. **Guide Contributors to Slack**: Direct everyone to the [`#playground` channel on WordPress Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K). This centralizes communication and enables asynchronous collaboration with late arrivals.
27+
28+
3. **Post a Welcome Message**: Share an initial message in the Slack channel announcing your presence (in-person or online) and welcoming contributions from everyone.
29+
30+
4. **Share Essential Links**: Post these resources in the `#playground` channel:
31+
32+
- [WordPress Playground Web Instance](https://playground.wordpress.net/)
33+
- [Playground Documentation](https://wordpress.github.io/wordpress-playground/)
34+
- [Playground Step Library](https://akirk.github.io/playground-step-library/)
35+
- [GitHub Repository](https://github.com/WordPress/wordpress-playground)
36+
- [Contributor Day guide](/contributing/contributor-day/)
37+
38+
5. **Introduce the GitHub Repository**: Provide a brief walkthrough of the repository structure, highlighting different packages and their purposes for first-time contributors.
39+
40+
## During the Day
41+
42+
### Managing Contributions
43+
44+
**Encourage Different Contribution Types**:
45+
46+
Check the contributors' levels, try to understand based on their level how they can contribute to the project in the short window of a contributor day. Ask if the participants need help and redirect them to the related documentation page. Also, encourage them to ask questions at the [#playground Slack channel](https://wordpress.slack.com/archives/C04EWKGDJ0K). Here are some suggestions for ways of contributing:
47+
48+
- Documentation improvements and translations.
49+
- Carefully crafted issues describing problems with actionable solutions.
50+
- Blueprint creation and plugin demos at the WordPress plugin repository.
51+
- Testing and product feedback.
52+
53+
**Foster Collaboration**: Look for cross-table opportunities. For example, contributors at the [Polyglots/Translation table](https://make.wordpress.org/polyglots/) might translate Playground documentation, or the [Core Test team](https://make.wordpress.org/test/) could provide valuable Playground feedback.
54+
55+
**Collect Feedback**: Ask contributors about their experience and note improvement suggestions. Report this in the [#playground Slack Channel](https://wordpress.slack.com/archives/C04EWKGDJ0K) if possible.
56+
57+
## After the Event
58+
59+
### Follow-Up and Support
60+
61+
1. **Review Pull Requests**: List PRs created during the day and assess their completion likelihood. Most contributions have a short momentum window—engagement within the first two weeks is critical.
62+
63+
2. **Set Clear Expectations**: For incomplete PRs, follow this approach:
64+
65+
- After one month of inactivity, leave a comment asking if the author plans to complete the work.
66+
- If no response after two more weeks, inform them that the PR may be taken over by another contributor or closed.
67+
68+
3. **Stay Active on Slack**: Continue supporting new contributors through the `#playground` channel, answering questions and helping them become regular contributors.
69+
70+
4. **Reflect and Improve**: Review collected feedback and your experience to refine this guide for future events. Feel free to submit a Pull Request to this guide!
71+
72+
## Getting Help
73+
74+
- **During the Event**: Connect with contributors at the Playground table.
75+
- **Ongoing Support**: Use the [`#playground` Slack channel](https://wordpress.slack.com/archives/C04EWKGDJ0K).
76+
- **Report Issues**: Submit to the [WordPress Playground GitHub repository](https://github.com/WordPress/wordpress-playground/issues/new).
77+
78+
For more information on contributing to WordPress Playground, see the [Contributor Day guide](/contributing/contributor-day).

0 commit comments

Comments
 (0)