Meeting - Contributor Guide Update - 17 November 2020

This meeting is on 17 November 2020 at 17:00 UTC** (9 AM US/Pacific, 12 noon US/Eastern) in the #documentation channel on Drupal Slack. This meeting is text-only, no audio or video, and is asynchronous so everyone can join in as they're available for about 24 hours. After that we'll capture notes from the threads.

Agenda - please feel free to edit this to add items!

Hello and welcome to the Contributor Guide Update meeting!

This meeting:
➤ Usually happens on alternate Tuesdays at 16:00 UTC in the northern summer, 17:00 UTC in the northern winter
➤ is text only!
➤ happens in threads, which you can follow to be notified of new replies even if you don’t comment in the thread. You may also join the meeting later and participate asynchronously!
➤ has a public agenda issue anyone can add to.
➤ :star: Meeting transcripts are still a work in progress, but please comment on the meeting agenda issue so we can grant you credit for attending/contributing!

:zero: *Roll Call!*
Who’s here today? Comment in the thread below if you’d like to introduce yourself and tell us something funny (because we can always use a little humor).

:one: Content status -- Migrations of Task section of the old Getting Involved Guide

:two: Content status -- Other areas:
- We need to continue to determine who the area heads are for the Area issues, contact them, and figure out what roles/tasks should be created for those areas. Parent issue: https://www.drupal.org/project/drupal_org_community/issues/3137918

:three: Meetings -- should we keep having them, and how often?

:four: *Anything Else?*: What else do we need to talk about?

That’s all for now!

The discussions continue in the threads! Please feel free to chime in within the next 24 hours to be captured in the meeting notes. Thank you very much to everyone for attending, learning, and contributing!

Meeting log

jhodgdon (she/her) Yesterday at 9:10 AM
:one: Content status -- Migrations of Task section of the old Getting Involved Guide




9 replies

jhodgdon (she/her)  1 day ago
The Contributor Tasks are pretty much all that remains of the old Getting Involved Guide (except a few other stray pages)

jhodgdon (she/her)  1 day ago
https://www.drupal.org/contributor-tasks

Drupal.org
Contributor Tasks
Note: This section is in process of being migrated to the Find a task page in the new Contributor Guide. Try searching there for a task instead of looking in this section -- some tasks have been moved there already. When the migration is complete, we will remove this section.
Feb 1st, 2012

jhodgdon (she/her)  1 day ago
We need to migrate them into "Contributor Task" content items so they will show up under the "Find a Task" page in the new Contributor Guide https://www.drupal.org/community/contributor-guide/find-a-task

Drupal.org
Find a task
Note: This is a work in progress! We are working on replacing the Getting Involved Guide with new content in a new organizational structure. Learn more about this project, and find out how to help, on the Getting Involved Refresh project overview page.
Feb 11th (39 kB)

jhodgdon (she/her)  1 day ago
But the problem is, I think some of the tasks are outdated/obsolete and I could use some help figuring out which ones are good and which ones are not... I am not sure how to get this feedback or who to ask. I've asked in the past few meetings but so far ...

jhodgdon (she/her)  1 day ago
I've also asked in the Mentoring channel.

rachel_norfolk  10 hours ago
Awesome work!

rachel_norfolk  10 hours ago
Yes - there is little doubt that tasks in lots of places are in need of review, now that we have them migrated

jhodgdon (she/her)  3 hours ago
I think what I'm going to try to do is post queries every few days about specific Contributor Tasks asking "Is this task still current and/or desirable to have?"

jhodgdon (she/her)  3 hours ago
Rather than trying to get feedback on all of them, which hasn't been working.

jhodgdon (she/her) Yesterday at 9:14 AM
:two: Content status -- Other areas:
- We need to continue to determine who the area heads are for the Area issues, contact them, and figure out what roles/tasks should be created for those areas. Parent issue: https://www.drupal.org/project/drupal_org_community/issues/3137918

Drupal.org
[Meta] Create content for Contributor Area sections
We need to create content for all of the Contribution Areas. Here are the guidelines for how/when/why to create a contribution area page: Guidelines for contribution areas. For each Contribution Area page, we need to create a child issue with the following summary: Develop/edit content for Contribute to WHATEVER IT IS Area Page of the Contributor Guide.
May 19th




2 replies

jhodgdon (she/her)  1 day ago
I have not made any progress on this lately, except that @MargyLY is working on organizing documentation about planning events for the Event Planning area https://www.drupal.org/community/contributor-guide/contribution-areas/event-planning

Drupal.org
Contribute by Planning Events
Note: This is a work in progress! We are working on replacing the Getting Involved Guide with new content in a new organizational structure. Learn more about this project, and find out how to help, on the Getting Involved Refresh project overview page.
Jul 14th (39 kB)

jhodgdon (she/her)  1 day ago
The event planning group provided a jumble of docs, and we got some from BADCamp as well, and I connected Margy to that documentation and set her loose.... Any status updates Margy?

jhodgdon (she/her) Yesterday at 9:15 AM
:three: Meetings -- should we keep having them, and how often?
9 replies

jhodgdon (she/her)  1 day ago
I'm not really feeling like the meetings are accomplishing much lately... I wonder if we should stop holding them?

jhodgdon (she/her)  1 day ago
The fact that today, no one has yet replied to any of the meeting threads is indicative...

jhodgdon (she/her)  1 day ago
Another thing we could do is broaden the scope of the meetings to include other documentation issues, and maybe have them only once a month. @eojthebrave @ambermatz and others involved in docs leadership -- would that make sense?

jhodgdon (she/her)  1 day ago
cc @rachel_norfolk

eojthebrave  24 hours ago
I don't personally have any specific projects that I'm working on. But I would be happy to help facilitate/participate in a monthly meeting. I could see it being useful in that documentation generally gets more interest when there are organized efforts going on. And just generally fostering the people who are interested in contributing. Ha. Helping with that space is something I think about frequently but just have not had the time for recently.

jhodgdon (she/her)  23 hours ago
That sounds good. Any particular time or day of the week that would be good for the monthly meeting? We've been having this meeting about the Contributor Guide on alternate Tuesdays at 9 AM Pacific time. So we could pick something like "First Tuesday of the month at 9 AM Pacific"?

ambermatz  23 hours ago
That time would be fine with me.

rachel_norfolk  10 hours ago
It probably does make sense to broaden the scope now, as that will allow documentation as a whole to be considered, in addition to the contributor guide. It all needs to work together to help someone on the edge of our community become interested in contributing and help them get more and more from the experience.

rachel_norfolk  10 hours ago
We have made a start on that road - and still some way to go, of course!

jhodgdon (she/her) Yesterday at 9:20 AM
That’s all for now!
The discussions continue in the threads! Please feel free to chime in within the next 24 hours to be captured in the meeting notes. Thank you very much to everyone for attending, learning, and contributing!




8 replies

rachel_norfolk  10 hours ago
It is fab that we now have so much content in the Contributor Guide. It has been a big effort to get there!
I think, maybe, what might be useful on the top level pages, is some further design work - maybe images etc to help guide people. I think one thing I want to do is get some input on how we can improve further the usability, now we have something to see

jhodgdon (she/her)  3 hours ago
Design is definitely not my strong point!

rachel_norfolk  2 hours ago
Yeah - we need to think about attracting it. I have a few ideas...

jhodgdon (she/her)  2 hours ago
We also need to make sure the text on the page doesn't get replaced by images though. Not everyone can see images.

rachel_norfolk  2 hours ago
Totally

jhodgdon (she/her)  1 hour ago
So... I don't see any links to the Contributor Guide from the main nav menu on drupal.org. If I were looking for it, I think I would look in Community or Give.  And maybe in the footer under Community. Should we make a drupalorg project issue to add those links (or somewhere else)?

rachel_norfolk  14 minutes ago
Yes!

jhodgdon (she/her)  10 minutes ago
I guess we probably need a drupalorg project issue to get that done... I'll make one and post in the drupalorg channel.