django / django/dsf-working-groups

Documentation on working groups and teams operations

Open
#59 4 comments 1 reaction 0 assignees View on GitHub
Dominant language
No language data
Stars
63
Forks
33
Avg merge
3h 36m
Merged PRs (30d)
3

Description

There are two opportunities for more docs on how we operate:

- General documentation on what is available behind-the-scenes, so new working group / teams charters have an easier time reusing what is already set up
- Group-specific documentation

## General docs

This could be just a new file or folder in this repository? Listing fundamental tools, and also nuances within those tools (related: #12). Thinking in particular of:

- Google Groups on the DSF Google Workspace, how they can be used as a public or private inbox, or for file permissions
- Google Drive folder structures and permissions management - in the shared drive, and group-specific private drives if needed
- DSF Slack channels, public, group-private, shared between groups
- DSF Slack groups, that make the above easier to manage
- Google Forms for group membership applications

In addition to facilitating the setup of the groups, having more documentation would encourage consistency, which would make common onboarding / offboarding tasks much simpler. For example noting we have to update the [Foundation Teams page](https://www.djangoproject.com/foundation/teams/).

## Group-specific docs

There is a natural need for groups to maintain documentation that isn’t a good fit for the main Django docs. I’m not sure what we should encourage here exactly, but most groups I’m on have a need for:

- Internal docs that go beyond the charter. Just more of the same with more details.
- Public docs to share information with other contributors in the areas the group operates.

---

I’d like to write some of those docs, not sure which exactly just yet, but it’d be great to get feedback from others on what specific needs they might have / thoughts on how to do this well.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.