[documentation] FormsAPI, Was:New Forms API tutorial

[Steven Jones]

Given my excitement at all the attention the Forms API section of the
handbook is getting recently, I thought that I'd pose a question or
two...

I don't like the way that Forms API is documented, there just isn't
enough, and it's scattered around all over the place. The reference on
a.d.o is awesome, but is on one huge page and isn't too nice to
navigate.

Now I'd like to change all that and put the reference into the
handbook section, so that others could edit and comment easily, but...

Navigation of the handbooks is worse than on a.d.o, and it would be a
major step backwards if the reference went in there, in terms of
navigation. So I was wondering how far off a docs.drupal.org is?
Perhaps with some lovely MSDN style tree view navigation?

Should I even bother? or should the Forms API section of the handbooks
contain a more in-depth introduction to forms in Drupal and other
'how-to' tutorials. I'd really like to clean it up but would like to
get some sense of what should go in it. I guess a general: what would
be useful? Is what I'm after.

Forms API -> http://drupal.org/node/37775

On Sun, May 25, 2008 at 5:41 PM, Steve Dondley <s at dondley.com> wrote:
> On Sun, May 25, 2008 at 12:36 PM, Addison Berry <drupal at rocktreesky.com> wrote:
>> Typically "credit" for who wrote or added to a handbook page is handled by
>> the revisions tab where folks can see the whole history of users.
>
> Please correct me if I'm wrong on this, but only those with permission
> can see the list of revisions.
>
> Even so, I'd still propose to build in a more public mechanism for
> giving credit to document contributors. Not only does it build Karma
> for them, it will encourage other to contribute so they can see their
> name "in lights".
>
>>
>> On May 25, 2008, at 12:16 PM, Steve Dondley wrote:
>>
>>>> I'm not sure it's a rule, but I think generally there is not an
>>>> attribution ("authored by") for handbook pages, since any of us may go
>>>> in and edit them.
>>>
>>> I just added a section to the top of the page where other contributors
>>> can be credited. If it gets too long, we'll revisit the problem.
>>> --
>>> Pending work: http://drupal.org/project/issues/documentation/
>>> List archives: http://lists.drupal.org/pipermail/documentation/
>>
>>
>
>
>
> --
> Prometheus Labor Communications, Inc.
> http://prometheuslabor.com
> 413-572-1300
>
> Communicate or Die: American Labor Unions and the Internet
> http://communicateordie.com
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>



-- 
Regards
Steven Jones