[documentation] Suggestions for re-documenting Drupal

Larry Garfield larry at garfieldtech.com
Thu Mar 20 01:05:46 UTC 2008


On Wednesday 19 March 2008, Marjorie Roswell wrote:
> 1. I agree with you about the need for improved documentation.
> 2. Totally agree that the book module (the hierarchy that you refer to)
> doesn't facilitate good documentation. I may have a different reason for
> feeling that: It's not the hierarchy that I object to: it's just that it is
> EXTREMELY time-consuming to use the drop-down to enter an item into the
> hierarchy. I think it's a huge barrier to adding content.
> 3. That said, I'm fairly well-resigned that the powers-that-be will almost
> never cede the book module model for doing this in favor of a wiki. I've
> seen it discussed on IRC, and the idea of using a wiki was met with such
> snideness that I basically resigned myself to living with incomplete
> documentation forevermore. I wasn't a participant in that conversation, but
> the tone of it seemed to be: this is how we do things, it isn't going to
> change.

I started writing a reply to this point, but it ended up a bit long.  So I 
made it a blog post instead:

http://www.garfieldtech.com/drupal-org-wiki

-- 
Larry Garfield			AIM: LOLG42
larry at garfieldtech.com		ICQ: 6817012

"If nature has made any one thing less susceptible than all others of 
exclusive property, it is the action of the thinking power called an idea, 
which an individual may exclusively possess as long as he keeps it to 
himself; but the moment it is divulged, it forces itself into the possession 
of every one, and the receiver cannot dispossess himself of it."  -- Thomas 
Jefferson


More information about the documentation mailing list