[documentation] [Documentation task] We should re-work the 'Contribute' link.

webchick drupal-docs at drupal.org
Thu Sep 14 23:23:49 UTC 2006


Issue status update for 
http://drupal.org/node/84172
Post a follow up: 
http://drupal.org/project/comments/add/84172

 Project:      Documentation
 Version:      <none>
 Component:    Misc
 Category:     tasks
 Priority:     normal
 Assigned to:  webchick
 Reported by:  webchick
 Updated by:   webchick
 Status:       active

Ok, I've started a new handbook section for this here:
http://drupal.org/node/84228


Just the text for now; I figure we'll tweak that and then work in the
graphics later.


If folks want to help flesh out the other sub-pages that would be cool.
I've done the user support one to start.




webchick



Previous comments:
------------------------------------------------------------------------

Thu, 14 Sep 2006 18:08:32 +0000 : webchick

Attachment: http://drupal.org/files/issues/contributions idea.pdf (104.66 KB)

Back at OSCMS in Vancouver, a gentleman (I believe Dale?) pointed out to
me that the "Contribute" section is rather un-friendly for new users. As
someone who genuinely wanted to contribute to Drupal, he was stuck
scratching his head about what to do with the plethora of links. There's
no real indication of "context" in terms of what these links are
actually for, nor a sense of "first do this, then do that." For some
reason I forgot about this until just now. :P


So here's an alternate idea of spiffying this up a little. It's in PDF
form just because it was easier for me to mock this up in Illustrator in
4 minutes than actually doing it. ;)


So basically, this page becomes a "jump-off" page to all the various
ways you can contribute to the project, and then each sub-page contains
more specific information. The "Contribute to documentation" page, for
example, would talk about how people should first join the documentation
mailing list, about the overall goal to incorporate comments into
handbook pages, and various tools we can use to gauge what are popular
pages, etc.


Thoughts?




------------------------------------------------------------------------

Thu, 14 Sep 2006 18:15:43 +0000 : webchick

a) Someone with actual graphic design skills should tweak the graphics,
colours, etc. :P


b) There would also be other sections like "Developing," "Testing,"
"Donating," etc. I was just trying to mock up something quickly.




------------------------------------------------------------------------

Thu, 14 Sep 2006 18:43:23 +0000 : Gary Feldman

I like it - a lot.




------------------------------------------------------------------------

Thu, 14 Sep 2006 18:51:37 +0000 : Michelle

I love it. If we go this route, and if people want to go with my
handbook change in http://drupal.org/node/84169  (shameless plug *grin*)
it would be nice if the same designer could do both. What webchick
mocked up (design-wise, not content) is exactly what I was going for on
the top level page of the handbooks so having them match would be great.


Michelle






More information about the documentation mailing list