Proposed Outline for the Getting involved Guide

Problem/Motivation

Based upon the personas defined in #3071311: Proposed personas for the Getting Involved Guide, we need an outline of the Getting Involved Guide, at the highest level, from which to work.

This outline does not need to define every single piece of content, only the major sections required and for whom they are developed.

See also these sites that are about finding volunteer opportunities (across non-profit agencies):
https://www.idealist.org/ (world-wide)
https://www.volunteerspokane.org/need/ (local to Spokane, WA)

Note that they both have various filters (geographic, time commitment, what the agency does [impact area], skills to be used, etc.).

Proposed resolution

Here is the proposed outline, including a summary of what each page/section would contain.

Getting Involved (landing page)

welcome; explain that the Drupal project is a world-wide community that comes together voluntarily to build and maintain the Drupal software, Drupal documentation, and the Drupal community; these areas are overlapping; this section exists to help people figure out fulfilling and productive ways to get involved in these efforts (find tasks to work on; learn about the logistics, policies, and politics of contributing); link to the Community landing page and explain what that is for, explain the organization of this section. Suggest an immediate way to get involved by completing a simple task, and then how to deepen involvement.

Help build and maintain the Drupal community (landing page with sub-pages)

Talk about the importance of having a healthy community in order to come together to build great software and documentation. Talk about the world-wide nature and diversity of the Drupal community, and inclusion. Talk about on-line vs. in-person interactions, local to regional to international scope. Point to the community landing page for an overview of the ways the community comes together. Overview of different ways that people can help build community (participating, organizing, mentoring, etc.). Link to contributor taks search.

Help build and maintain Drupal software (landing page with sub-pages)

Explain the organization of Projects (Drupal core, modules, themes, distributions). Explain that many different skills are needed (visual design, programming, usability, accessibility, translation, ...). High-level overview of the processes for contributing (Git repositories, issues, patch-based workflow, chatting on Slack, etc.), with links to specific information in the Reference information section. Initiatives in Drupal Core. Link to the Contributor task search.

Help build and maintain Drupal documentation (landing page with sub-pages)

Talk about the different types of Drupal documentation, and at a high level, how each is generated and maintained. High-level overview of the processes for contributing to each type of documentation, with links to specific information in the Reference information section. Initiatives in Documentation. Link to the Contributor task search.

Contributor task search

"Task library" with search/filter by skills needed, expertise level, time to complete the task, etc. Tasks would link to reference information pages rather than repeating the information. See comment #2 on this issue. Tasks would include things like attending a local Drupal meetup (with info on how to find one near you) -- make sure the tasks cover getting involved in Community, Software, and Documentation. [Maybe task is not the best word... is there something better?]. Each task needs to state its goal, time commitment, and skills needed (see more about that in the Skills section below). Also each task should be classified as to whether it relates to building community, software, or documentation.

Reference information for contributors

Sections/pages on how to use Git, make a patch, use the issue queue, etc. so that each Task in the Task library doesn't have to repeat the same information. I don't think this needs to have a filter/search function particularly.

Contributor roles search

"Roles library" that would describe different roles people can hold in the Drupal Community. Should include a "just getting started in contributing" role, and a "occasionally have time" role [not sure about those names, but we need to be inclusive and realistic about the time availability of some people, and still value their contributions.]. Roles should cross-link to tasks, but be more about the "why", level of commitment, and how filling this role has a positive impact on the project. Should include information about the time commitment, and we also need a page about how to gracefully step down from a role. Also each role should be classified as to whether it relates to building community, software, or documentation.

Skills browser

"Skills library" that would have a page describing each skill that someone could either use or improve in their contribution work. Would also describe how to learn the skill, and how to improve it via contributor tasks/roles. Contributor tasks and contributor roles would have entity references to these skills, along with an expertise level for each one, so that if you were on a page for a particular skill, you should be able to see the tasks/roles that need this skill, what level of expertise you need, and maybe a flag for "this is a good task for improving this skill".

Remaining tasks

Decide on the outline.