[documentation] DBTNG docs need review

[Nathaniel Catchpole]

Just saw the docs here have been updated -
http://api.drupal.org/api/group/database/7 - this could do with a link to
the handbook section too though probably.

Nat

On Thu, Dec 18, 2008 at 4:28 AM, Larry Garfield <larry at garfieldtech.com>wrote:

> On Wednesday 17 December 2008 11:02:29 am you wrote:
> > Hi Larry,
> >
> > Nicely done on the documentation. Everything is easy to read, and well
> > organized. Great job!
> >
> > One thing to note is that hook.api.php files made it into core
> > (http://drupal.org/node/314870), so are there any places with the new
> > database layer that would benefit from having any extra database.api.php
> > documentation files around?
> >
> > Thanks a lot,
>
> Hey neat, that made it in.
>
> I think DBTNG introduces only one hook, hook_query_alter, so I've opened an
> issue for that:
>
> http://drupal.org/node/348519
>
> I'm not sure that in-code is the best place to document the rest of DBTNG,
> beyond the docblocks already in database.inc.  The handbooks are probably
> better as it's less API samples and more prose explanations.  That said,
> I'm
> fine if someone wants to copy portions of the handbooks into a docblock.
> (Technically the licenses are incompatible, but as the original author of
> 98%
> of the DBTNG documentation I hereby dual-license it as needed yadda yadda.)
>
> --
> Larry Garfield
> larry at garfieldtech.com
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20081218/39fc7a0e/attachment.htm