[drupal-docs] First thoughts

[puregin]

On 24 Apr 2005, at 6:10 PM, judah wrote:

> I just joined this Drupal docs mailing list to suggest adding video 
> and images to the documentation but what I found was confusion.
>
> The discussions on this list are giving me a headache. You're making 
> this all more difficult than it has to be. (when I say YOU I mean no 
> one in general).
>
> What are the goals here?  Isn't it just to update the drupal 
> documentation? I'll do the whole book myself. Just give me a site that 
> has web based wysiwyg.

      With respect, a good deal of the discussion here has been around 
collaboration.   It's tempting to think that any of us could 'just do 
the whole thing ourselves' but in my experience that kind of approach 
too often leads to a collection of independent, 
started-but-never-finished projects and burned-out, disillusioned 
contributors.

> Just setup a drupal site, create the table of contents in the 
> taxonomy, setup one of the wysiwyg editors for those that want to use 
> it and then starting adding content underneath those terms. You don't 
> have to use the book module. Just add a very nice tree menu on the 
> side and let people navigate with that.

   Taxonomy is a probably not a good way to approach a table of 
contents.  To begin with,
the table of contents for the existing handbook has 740+ entries.   The 
issue of working with large taxonomies has its own thread.


> Is there problems with the book module? YES??? Then let's write them 
> all down and give them to dries and say, "we want to do the book but 
> we need these features fixed".

      Book module has shortcomings.   There is a process for reporting 
bugs, proposing features, and discussing solutions.  Let's take the 
discussion about book.module and other development issues over there.
>
> We *do* need to specify a few editors.

      I believe that there's a discussion in progress about "process" 
and workflow... which brings us nicely to your original question about 
goals and "what's going on here?"   Does anyone who's been on the list 
for a while want to give us a little summary of where things are?


>
> Or we could pool all our money together and hire someone to write the 
> book.
>
> Best Regards,
> Judah
>
>
--
puregin at puregin.org