Discussion:
Redefining the "docs team"
Addison Berry
2009-01-07 15:16:37 UTC
Permalink
Some of you may have seen some recent issues where I have started
"redefining" the docs team. Basically now that we have open editing,
everyone with a d.o account is on the "docs team" as far as I'm
concerned and I'd like to start phrasing it that way. We have also
removed a number of people from the "documentation maintainer" role on
d.o if they hadn't made any edits in a while since it just isn't
really necessary for most docs work anymore. In one of the issues,
Boris started editing the Join page (http://drupal.org/contribute/documentation/join
) to define things a bit better and I went ahead and did a bunch more
edits on that and other docs pages to make it clearer that everyone
can help with docs and that being "on the team" means more
responsibility and commitment. I have been denying recent requests to
join the team, explaining how much they can already do, and would now
like to see people give specific reasons to be added to the elevated
privileges of maintainer. I'd just like to do more in the way of
review of the work they have done and see if they have gotten a feel
for how d.o, the community and the docs work before adding privileges.

The people who do have these elevated rights, I'd like to put in the
more "correct" light (IMHO) of being the "maintainers" that the role
states, or even calling them "docs admins." Currently the docs admins
don't have a ton of elevated rights, but they can access the
Documentation input format (which allows images and tables) and they
have the ability to revert changes on the Revisions tab. In addition,
once we sort out the specifics of controlling placement of new pages
in the handbooks, that will be an admin task as well. As we head down
the road of the redesign there may be other things that we'd like to
have limited access to as well.

I guess I'd like the d.o community to be our "docs team" and the folks
that do extra work and have higher access would be the "docs admins."
If we notice someone doing a bang up job we can invite them to become
an admin and, of course, anyone can still request, we'll just look
things over a bit more.

So, what do you think?

- Addi
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Benjamin Melançon
2009-01-07 16:52:42 UTC
Permalink
I think it's a good plan.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Pratul Kalia
2009-01-07 17:17:32 UTC
Permalink
Neat enough as I see it.

After all, "open source documentation doesn't have to suck always." :-)
Emma Jane Hogbin
2009-01-07 17:21:20 UTC
Permalink
Post by Addison Berry
I guess I'd like the d.o community to be our "docs team" and the folks
that do extra work and have higher access would be the "docs admins."
If we notice someone doing a bang up job we can invite them to become
an admin and, of course, anyone can still request, we'll just look
things over a bit more.
People are joiners. They like to be on teams. I wonder if it will feel
like it's enough to automatically have a d.o account and be on the docs
team?

I love that everyone is automatically on the team; and I also like using
"admin" to signify "moar powah." But I think people will continue to ask
to be "part of the team" unless there's some kind of shiny button they
can push to self-promote. What about modifying the profile for
documentation so that instead of, "I contributed Drupal documentation"
it says, "I participate on the Documentation Team." Or something like that?



regards,
emma
Addison Berry
2009-01-07 18:06:13 UTC
Permalink
Ok, so we define the "docs team" as anyone who actually contributed to
docs in some way. ;-) So if you want to be "on the team" you need to
edit/create docs. In that respect, this: http://drupal.org/node/14205
and this: http://drupal.org/node/263594, is our docs team. I've no
problem changing the wording of the profile linky.

On a side note, I'd like to just consolidate the "contributor" and
"editor" pages into one list. Having them separate isn't terribly
useful to me. We should also note that right now, the numbers printed
after the names of contributors are pretty much inaccurate and
useless, so I'd like to remove them. I think one page that lists
everyone (create and edit0 is fine. If we want a number for ranking,
we can use one number indicating the number of handbook pages
"touched," whether it be initial creation or editing, with only one
touch per page (as in, no "I made 5 minor edits to one page so I get 5
credits." - you just get 1 credit per page).

- Addi
Post by Emma Jane Hogbin
Post by Addison Berry
I guess I'd like the d.o community to be our "docs team" and the folks
that do extra work and have higher access would be the "docs admins."
If we notice someone doing a bang up job we can invite them to become
an admin and, of course, anyone can still request, we'll just look
things over a bit more.
People are joiners. They like to be on teams. I wonder if it will feel
like it's enough to automatically have a d.o account and be on the docs
team?
I love that everyone is automatically on the team; and I also like using
"admin" to signify "moar powah." But I think people will continue to ask
to be "part of the team" unless there's some kind of shiny button they
can push to self-promote. What about modifying the profile for
documentation so that instead of, "I contributed Drupal documentation"
it says, "I participate on the Documentation Team." Or something like that?
regards,
emma
--
Emma Jane Hogbin
ph. (519) 371-2665
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Lynette
2009-01-07 19:34:48 UTC
Permalink
Post by Addison Berry
touch per page (as in, no "I made 5 minor edits to one page so I get 5
credits." - you just get 1 credit per page).
Darnit, there goes my plan to take over the top spot on the list!

OK, really, I like it better because when I edit, I tend to make a
couple of changes, save it, make a couple more changes.. or I'll do
something dumb like screw up a hyperlink. So that means multiple edits.

I also agree with merging editor and contributor lists - there's been
plenty of times I've seen people go through and rewrite entire sections
of pages or add chunks (I know I have) and there's a point where that's
no longer 'editing', it's *contributing* new work. I've never made a new
page, but I've added paragraphs to pages. :) And anyone who really wants
to see the changes made can go look around and find them anyway.



--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Emma Jane Hogbin
2009-01-07 20:43:01 UTC
Permalink
Post by Addison Berry
Ok, so we define the "docs team" as anyone who actually contributed to
docs in some way. ;-) So if you want to be "on the team" you need to
edit/create docs. In that respect, this: http://drupal.org/node/14205
and this: http://drupal.org/node/263594, is our docs team. I've no
problem changing the wording of the profile linky.
Love it.
Post by Addison Berry
On a side note, I'd like to just consolidate the "contributor" and
"editor" pages into one list. Having them separate isn't terribly
+1
Post by Addison Berry
useful to me. We should also note that right now, the numbers printed
after the names of contributors are pretty much inaccurate and
useless, so I'd like to remove them. I think one page that lists
everyone (create and edit0 is fine. If we want a number for ranking,
we can use one number indicating the number of handbook pages
"touched," whether it be initial creation or editing, with only one
touch per page (as in, no "I made 5 minor edits to one page so I get 5
credits." - you just get 1 credit per page).
Accurate numbers are always better. I'm also fine with the list being an
alphabetical list for all contributors, and scrapping the numeric
ranking. It can always be generated as a stat from time to time if need be.


regards,
emma
Addison Berry
2009-01-07 22:36:28 UTC
Permalink
Post by Emma Jane Hogbin
Accurate numbers are always better. I'm also fine with the list being an
alphabetical list for all contributors, and scrapping the numeric
ranking. It can always be generated as a stat from time to time if need be.
OK, I've submitted an issue and a patch at http://drupal.org/node/
355767. Basically it gets rid of the editor page and goes back to just
a contributor page. That page just lists names of anyone who has
created or edited a handbook page. It is ordered by most recent
edits. ;-) So if you want to be at the top, keep up the good work.

I also removed the lead text on the Maintainer page so we can edit
that as we see fit without needing to do a patch to the module every
time. That means we can still discuss/change wording as we go.

- Addi
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Emma Jane Hogbin
2009-01-07 22:46:42 UTC
Permalink
Post by Addison Berry
Post by Emma Jane Hogbin
Accurate numbers are always better. I'm also fine with the list being an
alphabetical list for all contributors, and scrapping the numeric
ranking. It can always be generated as a stat from time to time if need be.
OK, I've submitted an issue and a patch at http://drupal.org/node/
355767. Basically it gets rid of the editor page and goes back to just
a contributor page. That page just lists names of anyone who has
created or edited a handbook page. It is ordered by most recent
edits. ;-) So if you want to be at the top, keep up the good work.
Awesome. :) Will it explain what the order is for the list? or maybe
have a "last activity" time stamp instead of the count stuff? On reading
the patch it just looks like names will be listed?
Post by Addison Berry
I also removed the lead text on the Maintainer page so we can edit
that as we see fit without needing to do a patch to the module every
time. That means we can still discuss/change wording as we go.
Yay for editing without having to patch! :)



regards,
emma
Addison Berry
2009-01-07 23:53:55 UTC
Permalink
Post by Emma Jane Hogbin
Post by Addison Berry
OK, I've submitted an issue and a patch at http://drupal.org/node/
355767. Basically it gets rid of the editor page and goes back to just
a contributor page. That page just lists names of anyone who has
created or edited a handbook page. It is ordered by most recent
edits. ;-) So if you want to be at the top, keep up the good work.
Awesome. :) Will it explain what the order is for the list? or maybe
have a "last activity" time stamp instead of the count stuff? On reading
the patch it just looks like names will be listed?
Yep, just names. We can edit the lead text on the page (not in the
code, thankfully) to explain the sort order and anything else we
want. :-)
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Nancy Wichmann
2009-01-07 21:23:43 UTC
Permalink
the numbers printed after the names of contributors are pretty much
inaccurate and useless, so I'd like to remove them.
Oh, boo hoo, I liked being number 2! It gives me something to put on my
resume.

--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Addison Berry
2009-01-07 18:08:56 UTC
Permalink
Hmm, sounds nicer! In fact, the page
http://drupal.org/documentation-team shows 232 people currently. In my
opinion as I see it, we chould change that list to Docs Admins and
prune it down to the people that have 'admin' access.
The 232 on that page *are* the pruned down "admin" group. The list of
all contributors are http://drupal.org/node/14205 and http://drupal.org/node/263594
. And yes, we can change the working on all of these list pages to
point out this new definition of things... once folks agree. :-)

- Addi
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Pratul Kalia
2009-01-07 18:00:35 UTC
Permalink
Post by Emma Jane Hogbin
I love that everyone is automatically on the team; and I also like using
"admin" to signify "moar powah." But I think people will continue to ask
to be "part of the team" unless there's some kind of shiny button they
can push to self-promote. What about modifying the profile for
documentation so that instead of, "I contributed Drupal documentation"
it says, "I participate on the Documentation Team." Or something like that?
Hmm, sounds nicer! In fact, the page
http://drupal.org/documentation-team shows 232 people currently. In my
opinion as I see it, we chould change that list to Docs Admins and
prune it down to the people that have 'admin' access.

The rest of the people on d.o already have basic access to edit the
documentation pages. They are already a part of the happy Docs family
:-) Those people can display "I contribute to Drupal documentation" or
something, as Emma Jane rightly put it. That way I think we won't lose
that i-am-on-a-team feeling.


cheers
pratul

Loading...