How to Make a New Working Group
This page is under construction. Feel free to help build it!
There also an effort to create an OEP to formalize the working group system: https://github.com/openedx/open-edx-proposals/pull/424. It’s currently on the back burner, but you can take a look and leave feedback if you’d like.
Table of Contents
Prerequisites
These were carried in from Working Group Guidelines and Definitionarchived.
The topic must be related the Open edX platform, its community, or one of its use cases.
There must be adequate control and feedback into the Open edX community. A working group functions with bidirectional communication with the larger community
Generally all communication as to the work of the working group should be public, understanding that sometimes a matter may need to be private. In such cases, please consult with Open edX leadership.
All code produced within the working group must be compatible with a license presently used by Open edX platform.
All documentation produced within the working group must be licensed under a Creative Commons share alike license (CC-BY-SA).
Any code generated by the working must be published in a repository in the openedx GitHub organization.
All code contributors must either sign an individual Open edX CLA be specifically included under their organization's Open edX CLA.
Name and purpose
Come up with a short name for your group and a few sentences describing what your new group will try to do.
Check out the list of existing working groups to see if there are any groups whose purpose overlaps with yours. If so, consider joining that group instead, and/or creating your group as a sub-group.
Announcement and chairperson
Announce your working groups on the Open edX forums. Example: https://discuss.openedx.org/t/introducing-the-developer-experience-working-group/8834
If you are unsure whether you want to create the group and want community input, frame it as a proposal. If you’re certain that you want to make the group, frame it as an announcement. Either way, be clear about what you see the group doing and how you see it operating, and seek to find interested collaborators.
State whether you intend to be the initial chairperson or are seeking nominations for a initial chairperson. You will need to find a chairperson for the next steps, even if they’re just acting as an interim chair.
Setup
As the chairperson, set up each of the following. For anything you lack access to do, you can open up an Axim Request (feel free to batch a bunch of them together into one request).
Wiki | Create a wiki page underneath . Include your name, purpose, chairperson & any other named roles, communication methods, meeting times, and any other info that would help new collaborators jump in and get involved with your working group. Consider adding a sub-page to hold agendas, notes, and recording links for your meetings. Example: . Add a listing to the table on , following the pattern set by the other working groups. |
|---|---|
Calendar | If your working group will have regular meetings, add them to . In the event’s description, include links to wherever you will hold your meeting agendas/notes. |
Slack | Create a new public channel in the Open edX Slack workspace, prefixed with Add yourself (the WG chair) to the |
Forums | Create a subcategory on discuss.openedx.org underneath Example: https://discuss.openedx.org/c/working-groups/build-test-release |
GitHub | Create a new public GitHub repository in the openedx organiztion to hold issues for your working group. Grant access to the repository:
Example repository: https://github.com/openedx/wg-developer-experience Also create a new publicly-readable GitHub project in the openedx organization. This will let you organize your issues into boards. You, as the WG chair, should be granted admin access to the project. Example project: https://github.com/orgs/openedx/projects/37 |
Ask the Marketing WG in |
Anything else?
These are new instructions. If anything seems missing, add it here!