I've used this technique before and find it very helpful in compiling documentation. The resulting API has an entire topic devoted to FormsAPI calls, which makes finding forms simple. I can spare a few patch cycles if we decide to go forward. - Ken Rickard agentrickard On 7/13/07, Earl Miles <merlin@logrus.com> wrote:
I would like propose that Drupal 6 (and forward) adopts the following documentation standard:
For all functions that are meant to be used in as an argument for drupal_get_form, we document them with @ingroup forms (note that actual form code is documented via @ingroup form) and we put a description of what the form is meant to be used for. That will make it a little easier to for users to discover what forms are available and find their way to the code that generates the forms.
(Could also use volunteers to help apply documentation patches to get this done).