documentation Digest, Vol 40, Issue 17

[Nick]

You all have been really fantastic with the feedback... I've posted some
more on the issue page at http://drupal.org/node/236444 It seems more
appropriate to centralize discussion there.

Send documentation mailing list submissions to
To subscribe or unsubscribe via the World Wide Web, visit
http://lists.drupal.org/listinfo/documentation
or, via email, send a message with subject or body 'help' to
You can reach the person managing the list at
When replying, please edit your Subject line so it is more specific
than "Re: Contents of documentation digest..."
1. Re: Suggestions for re-documenting Drupal (Addison Berry)
2. Re: Suggestions for re-documenting Drupal (Marjorie Roswell)
----------------------------------------------------------------------
Message: 1
Date: Wed, 19 Mar 2008 21:40:17 -0400
Subject: Re: [documentation] Suggestions for re-documenting Drupal
Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes

apologies for bad descriptive term!
What's the best URL for continuing the conversation? Not quite sure
where to go. (email's easiest for me, if some other location, let me
know.)

Well the original issue for the points in it, but the conversation has
listed a bit form that so we should probably continue this discussion
here. :-)

Honestly, I think the drop-down data entry form is a huge barrier to
content entry, and as you noted, especially for new content entry...
but most modules aren't in the documentation... so lots of room for
new entries. Also, seems many things will require new pages for v6
(or is that not accurate?)

Just because it is new content doesn't mean you need to use the
dropdown. I didn't say new content entry is a problem, because its not
unless you are creating a new top-level item or trying to move an item
from one place to a very different place. Both of those activites are
pretty rare on d.o which is why I said the dropdown is not an issue
99% of the time and typically the folks that do encounter it are d.o
site admins, not average docs team folks.
New content should be created with the Add child page link. You just
go the page that will be that parent for your new page and click the
Add child page link. That does the placement for you. E.g. if you
wanted to add a new module handbook page in the Event modules section,
just go to http://drupal.org/node/206786 (the Event modules page) and
click the Add child page right there. Easy peasy. You don't even need
to be on the docs team to do that. Everyone with a d.o account can add
child pages wherever, whenever they want.

How does wikipedia handle spam? Honest question.

I don't know, I'm not that familiar with it other than reading
articles there.

Margie

------------------------------
Message: 2
Date: Wed, 19 Mar 2008 22:32:43 -0400
Subject: Re: [documentation] Suggestions for re-documenting Drupal
Content-Type: text/plain; charset="iso-8859-1"
http://www.garfieldtech.com/drupal-org-wiki
I've since recorded a tiny little (15-second?) screencast to show what I
mean by the search drop-down ajaxy thing (based on civicrm search) that I
mentioned in the last paragraph. Might be a good way to handle the
documentation dropdown piece.
http://screencast.com/t/qvGyH5TxRyt
-------------- next part --------------
An HTML attachment was scrubbed...
http://lists.drupal.org/pipermail/documentation/attachments/20080319/3e497747/attachment-0001.htm
------------------------------
_______________________________________________
documentation mailing list
http://lists.drupal.org/listinfo/documentation
End of documentation Digest, Vol 40, Issue 17
*********************************************