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

sepeck drupal-docs at drupal.org
Fri Sep 15 01:17:01 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:   sepeck
 Status:       active

The text appears fine for the most part.  I do think the the Header lead
in should be changed from 'Thank You!' to 'Welcome'.  The first
paragraph text then has the Thank you, etc.


The second paragraph uses the word 'newbies', why can't we just use the
phrase 'Even the most gifted Drupal developers were new once,' without
the slang word 'newbies'?  I am not sure how 'newbies' translates across
languages.


We don't have any big spots of color anywhere else on Drupal so if you
want that, I suggest chatting with Steve Whittens.  Otherwise all the
other pages use two colum bodies to do present this info using <div
class="column-left"> and <div class="column-right"> in the page itself
and I think we should remain consistent with that look.


Once we agree on the text, etc I can make the change.




sepeck



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




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

Thu, 14 Sep 2006 23:23:49 +0000 : webchick

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.






More information about the documentation mailing list