Create a Manual
I've been considering starting a manual for the 'pg' library, but haven't had the time or motivation to do so up to now.
Ticket <<issue 78>>, while a poor example of issue-reporting, had a kernel of truth within the rude hyperbole: there really isn't any good resource (that I know of) on how to start using the 'pg' library, especially the more-advanced features. I usually just refer to the C API docs, which are excellent, because 'pg' maps to the
libpq API pretty much one-to-one. But that's not intuitive, and translating the C into idiomatic Ruby isn't really straighforward.
After converting the build system to use Hoe, I'm going to add the 'hoe-manualgen' plugin, and start working on a cookbook-style manual like [[http://deveiate.org/code/Treequel/|the one I did for Treequel]].
I'll start with an outline, split it into pages, and once I have the initial section done, perhaps solicit people's help in finishing up the rest.