[documentation] Re: [drupal.org] FAQ

[Steven Peck]

We do incorporate relavant comments into handbook pages
(http://drupal.org/node/14345).  I know that Amazon and I alone have
each reviewed and acted on over 300 comments each in January.  Several
others have also done this as well.

This page: http://drupal.org/handbook/comments was created to help aid
this process.  Some of the more complicated comments (usually php or
code examples) are harder and more time consuming to do so sit much
longer.  

If you can fix a page, please do so.  We have revisions available.  Some
of the older pages do not have revisions by default so just keep an eye
out, but if you have the rights to edit the pages, you have the trust
that you will do so responsibly.  Please excersice your responsibility
and trust as you can.  We appreciate it.

If you want to make structural changes then either email the list or me
to discuss.  I'm all for improvements.  Part of documentation is
consistency and organization.  Part of learning something new is
learning how to learn and use it's resources.  

Drupal is so complex and flexible that no one way of docuemnting it is
going to solve all the needs.   That's why I'm for keep a structure and
then provide a FAQ with links to the detailed stuff in the current
structure.  As people learn how to use and locate information in the
handbook they will refernce the FAQ less and less.

If we do the FAQ in the top level http://drupal.org/node/258 then you
can divide up the FAQ's section as you see the need to.  Also, as
content grows we can reference it in our signatures and other pages on
Drupal.org.  

I'm still regarding this as a discussion so pro's and con's.....

I apologize for my recent lack of activity, there are some work issue's
which completely dominate my attention in the recent weeks.

-sp

> -----Original Message-----
> From: documentation-bounces at drupal.org 
> [mailto:documentation-bounces at drupal.org] On Behalf Of Kobus Myburgh
> Sent: Friday, April 28, 2006 1:02 AM
> To: documentation at drupal.org
> Subject: Re: [documentation] Re: [drupal.org] FAQ
> 
> > The amount of answers among comments is exceptionally low. Ideally, 
> > relevant issues found among the comments should be 
> incorporated into 
> > the
> 
> I think so too, particularly for the handbooks. I do however, 
> feel that comments deep down in a support forum thread means 
> a lot at times.
> 
> I am wondering if we should not disable comments on the 
> handbooks (or at least make them unpublished by default)? 
> This would make things a lot more easier to navigate...
> 
> > However, it is a distinct task from creating a FAQ, and you 
> don't have 
> > to tackle it entirely by yourself. Since this is supposed to be a 
> > documentation *team*, why not post issues
> 
> I agree - and I will do so, but if it is something I can fix 
> satisfactorily, I will do so myself - will sometimes longer 
> to submit the issue than to fix the problem.
> 
> Kobus
> 
> 
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
> 
>