[drupal-docs] First thoughts

[Anisa]

I agree with everything in this post.  ^.^  Including the headache part.

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.
>
> 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.
>
Handbook should not be moved off drupal.org.

> 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".

heh...  my preferred response to this violates my principles of 
happiness and lollipops...

I will say that feature requests were filed for the book module. 

> We *do* need to specify a few editors.

Certainly!  I understand there are several Site Maintainers (3 of which 
are Gerald).

> Or we could pool all our money together and hire someone to write the 
> book.

No.  ^.^  It's a really sad state when you can't even write your own 
handbook.

OK, so, in your opinion, the needed thing is a wysiwyg thingy?  Perhaps 
the HTML Area module?  Or the TinyMCE one? Needs to be just for the 
handbook text fields, so perhaps the TinyMCE.

Consistency makes things easier to read, and a stricter style guide will 
make it easier on the writers in the sense that it is clearly laid out 
what is expected out of a handbook page.  So I still strongly advocate 
that, but last night, I was thinking, it would be kinda messy to 
implement a wiki that is not tied into drupal itself.

Anisa.