Help us write a new Contributor Guide

We encourage users to post events happening in the community to the community events group on https://www.drupal.org.
jhodgdon's picture

How did you first get involved with contributing to the Drupal project? If you're like me, it was at a DrupalCon contribution day, where a wonderful mentor guided me through the pitfalls of joining in to our global project. But not everyone has the chance to attend a DrupalCon or other event with mentors, so many people instead try to navigate through the "Getting Involved Guide" on drupal.org to figure out how they can contribute. Unfortunately, it is not our best collection of documentation -- it is hard to navigate in order to find either a quick task to do to get started contributing, or a longer-lasting role to fit into.

So, some of us have been thinking for a while about how to make use of Drupal to provide a better Contributor Guide. Over the past few months, we created some new content types and views for drupal.org, and they just got deployed.

And that's where you come in: it's time to write the content for this new section! There are two tasks that are currently ready for you to work on, and you can do each of them several times.

Write content for Skill pages

I've made starter pages for the "Skills" pages for the new Contributor Guide (see link above for a description of the content types), and they all need content and editing. To work on this task:

  1. Find a skill page to edit here: https://www.drupal.org/community/contributor-guide/use-or-improve-your-s... -- scan down the list for ones that have "needs details" in their summary lines.
  2. Click the title to go to the skill page you want to edit
  3. Click Edit, and edit the page (you'll need to be logged in). Follow these guidelines:
    -- Leave the title as it is -- if it needs adjustment, discuss in Slack in #documentation
    -- Remove the "needs details" from the summary line so that we'll know it doesn't still need details
    -- If you have questions, or want someone to review what you wrote, post a message in Slack in #documentation ; if you don't use Slack, you can post a comment here to get help (but it might take a few days).

Create new Task pages from existing Contributor Task pages

The other thing that we can start doing now is creating new Task pages. We have some existing pages in the Getting Involved Guide that describe tasks, and migrating these to the new format should be fairly straightforward (I hope!). To help with this effort:

  1. Find an existing task page under https://www.drupal.org/contributor-tasks
  2. Make sure that the task doesn't already exist on https://www.drupal.org/community/contributor-guide/find-a-task
  3. Go to https://www.drupal.org/community/contributor-guide/background-and-refere... to read about the new content types and find out how to create a Task
  4. Copy and/or adapt the text from the old source page to make a new Task
  5. We will eventually want to delete the old task page and redirect to the new page. So, post a comment on this issue to ask for that to be done (include the old/new URLs of the source/new page): https://www.drupal.org/project/drupal_org_community/issues/3138007

Comments

Thank you so much for getting

rachel_norfolk's picture

Thank you so much for getting us this far, Jennifer!

Being able to create some structure behind how we describe all of the things that people do in the community os going to be really powerful and will help us all be more aware of how essential each one of us is to the sustainability of the project. Going to be interesting to see what this looks like when full!

Awesome - happy to help

Webbeh's picture

Awesome - happy to help kickstart some content for the Skill pages. Thanks for the charge and leadership on this.

Joining the slack channel

ketansevekari's picture

Can you tell me how do I join the slack channel #documentation?

Instructions to join channels in Slack

siliconmeadow's picture

Hi,

Provided you are logged into slack, notice the l subsection on the left-hand side which says channels. Click on the plus (+) button next to 'Channels' and then choose 'Browse Channels'. Then search for 'documentation' in the search field (or other channels you might be interested in, too). Click on it, and then choose 'Join channel' at the bottom of the page.

slack instructions

Documentation

Group categories

Event type

Post type

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: