[documentation] FormsAPI, Was:New Forms API tutorial

[Steve Dondley]

I vote for moving them into one central location at d.o. Make the most
sense to me.

On Sun, May 25, 2008 at 5:27 PM, Steven Jones <darthsteven at gmail.com> wrote:
> 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
> --
> 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