Add "Documentor" card to Contributor Cards

This is totally possible.
It just needs wording and tasks that can be identified as deliverable achievements, in a similar format to the others.

Before our sprint, we tried and failed to come up with enough appropriate tasks that didn't end up nebulous "Improve a handbook page on drupal.org" or hard to follow through without eventual code work "Add a step to tour.module for part of the UI that you think needs it".

Please lets get some ideas on the wording you want to see! We should come up with half a dozen, one-sentence tasks that are as substantial and do-able, and as the ones on the other cards.
Given the *content*, there should be nothing preventing anyone dropping it into a template.

Here's a first pass at some text for this card:

I moved this text to the issue summary so others can help refine it ...

I would also recommend that we update the "Explorer" and "Community Contributor" cards to indicate the "Documentor" is a possible next step.

I think that some of the things about being and explorer, and a community contributor are needed before contributing to documentation. (they need to know something about what they are documenting, and they need a drupal.org account and to be in irc).

Note that all the other role cards talk about drupal 8.
We use these for the Drupal Core Mentored Sprint, which has a Core (drupal 8) focus.

I suggest it start with

You are a Community Contributor and ready to start documenting Drupal 8.

Or maybe

You are a Community Contributor, a good writer in English, and ready to share knowledge about Drupal 8 with others.

(that might be too long, and there might be some strange grammar in that wording)

many of the other cards, if you add up the checkbox things under get ready, sprint, bonus, continue at home, have between 9 and 12 checkbox items.
This has 14.

I think we should scale back the items both for layout space reasons, and also so we do not overwhelm the new documentors.

they should be in the docs irc cannel while sprinting.. not just at home IMO

I put it first under get ready to sprint, because that is where they can ask questions about how to do the stuff on the sprint card (in addition to working with people in the room).

Note, we avoid URLs on the cards, so we may want to phrase these things more specifically....
OH, I see we took out the online versions when we moved to github.
https://www.drupal.org/node/2306609/revisions/view/7762059/8033509

I think we might want to consider having something that would generate the online version to put on d.o which could have links, but still track changes through github.
I will post a comment about that on #2269681-98: (BCN, Due: 2015-08-20) Contributor role cards and stickers for booth

Check out can mean something very specific with regards to git, and might not be easy for non-native english speakers to understand.

I think what we mean is "Read"

--

I think the screenshots style guide has some hints about how to take screenshots, so reading that could be helpful to do first.
ohh... no it does not. ok. leaving the order as it was.

--

I think the tag does not have a # in it.

I rearranged some checkbox tasks, moved the issue queue ones to bonus.
(so that people who do the others, but do not get to them will not feel like they didn't get enough done)

--

I removed the
- Answer a question in the support forums

line.

because this reduces the number of things on the card (good)
and because I'm not sure this is an actual recommendation that has community consensus. (things have been moving off the forums).

The other cards have periods at the end of their task sentences. Making this consistent with that pattern.

also added Core to the office hours line (might want to check other cards to make sure we are referring to them all the same way).
took "the" out of the irc channel line. (instead of adding in the word "channel")

updated remaining tasks

Thansk @YesCT. Great suggestions.

I've made a few more tweaks. I combined the two bonus elements that relate to finding issues in the queue to a single line, and I've combined the review style guide, and review screenshot instructions into a single element as well. This helps to tighten things up.

I also did a little bit of wordsmith/tweaking after doing a few Google searches to try and help make sure people get to the right pages.

As far as I'm concerned the content for these is good. As long as it fits well into the print layout.

I might be jumping the gun here, but I made a pull-request to help keep things moving along. https://github.com/drupal-mentoring/drupal-contributor-roles/pull/8

Though, we should probably still get some reviews in this issue first I suppose. :)

Changing this to needs review so that it's clear what the next step is.

The thing that needs reviewing is the text for the proposed documentor card, either in the issue summary above, or in this pull-request. They are both the same text, so whatever is easier for you to read. https://github.com/drupal-mentoring/drupal-contributor-roles/pull/8

a good writer in English

Sounds a little *not* to me.
I suggest

competent in written English

I read through the corresponding contributor tasks - and they seem really well done..
I like what has been happening in Documentation this year. The top-level topic page rewrites are landing well, and the This month in Drupal documentation updates show a lot of activity.
I really do think that this idea of actively encouraging documentation as a sprint task is a great idea.

I think this is an AWESOME idea.

And I just updated the issue summary based on D-man's suggestion.

Here's a stab at the HTML version

I think it would be good to add a note about helping out with the Drupal 8 User Guide, at least during BCN this could be a great way for someone to get involved. https://www.drupal.org/project/user_guide

Maybe either as a new sprint task, or, as an additional item listed along with the d8docs tag and the documentation issue queue.

We need to finalize this. running out of time for BCN.

Here's a version of this with a task added for helping out with the Drupal 8 User Manual.

<li>Work on writing, editing, or reviewing the Drupal 8 User Manual. https://www.drupal.org/project/user_guide</li>

As far as I'm concerned this is good to go now.

I used @eojthebrave's version to have a crack at the layout in inkscape (and included that dot point in the issue summary)

We can't add SVGs here, so I've added .txt extension to the SVG file. Just remove that to get the editable version. PDF and PNG for proofing also attached.

Not sure what the original font was for the others though, but that's an easy fix.

Oh - we probably need a follow up - to update the progression diagram on the other cards to include the documentor option.

I'm thinking I need to redo the progress diagram.

The Documentor follows community contributor - not issue mover.

Putting back to needs work

Revised process diagram - does that work?

Works fine for me. The items appear in the right order/progression and it's easy enough to read. Thanks! Should we open a follow up issue for updating the rest of the cards and then call this one good to go?

Translated to Spanish in the IS.

re #27: The letters on DC & DV don't make sense to me any more in the little process diagram.

The titles of the actors in Spanish I feel should also be translated. Right now they are still in English, even though the rest is translated. And mentions of IRC could (should?) mention #drupal-es, not just #drupal.

this looks fine to me.
some of the items on the card would be useful to have links.... are those in a contributor task document? https://www.drupal.org/contributor-tasks

we have
"Add keywords to a Community Documentation page" https://www.drupal.org/contributor-tasks/add-keywords
I know where to find the manual g.d.o announcement... but can we get each of the items documented here with links (at least for a start)

@heddn we decided not to translate the titles, since in english, they are gender neutral and in other languages, when we make them gender binary they get long by listing both a male and female version. And when we leave the titles in english, the same first letter can be used in the diagram. See discussion in #2269681-64: (BCN, Due: 2015-08-20) Contributor role cards and stickers for booth

I should read the issue summary. the links are in there. :)

I reviewed the spanish translation and seems good to me, but I sugest a change to make it gender neutral:

"Eres Community Contributor con nociones de escribir en inglés, y estás preparado o preparada para compartir tus conocimientos sobre Drupal 8 con otros."

Could be:

"Eres Community Contributor con nociones de escribir en inglés, y tienes la preparación para compartir tus conocimientos sobre Drupal 8 con otros."

Agree with David suggestion. We should reach consensus if there isn't yet about doing this card or not, and dump this into https://github.com/drupal-mentoring/drupal-contributor-roles. Handling this through issue queue will be tough.

Pull Request created: https://github.com/drupal-mentoring/drupal-contributor-roles/pull/9

Cool! Let's do it :)

PR is merged. What else do we need for marking this one as Fixed?

From https://www.drupal.org/node/2269681#comment-10189842

Should be documentor or documenter? https://en.wiktionary.org/wiki/documenter

I added a new PR to fix the issues reported on #2269681: (BCN, Due: 2015-08-20) Contributor role cards and stickers for booth.

https://github.com/drupal-mentoring/drupal-contributor-roles/pull/12

I'm closing this issue as as part of issue queue clean-up meta: #2960983: [meta] Plan for Mentoring Project/Issue Queue. This does not mean topics in this issue is or was not important or completed.

Issue was used for DrupalCon Barcelona and as is can be considered outdated.