Initial Documentation

[adnelson]

Usage docs

• High level description
• a few short code examples

Building SELECT queries

• Expressions
• Joins
• Group by, limit, where, etc

Decoding results

• Just enough about running queries to enable example code
• Decoding a single row (e.g. from a query returning a single result)
• Decoding an object from multiple rows

Building INSERT queries

• Insert select
• Insert values
• Encoding objects into VALUES
• Handling return values

Running queries

• writing code for a generic client
• Choosing the DB driver directly (e.g. BsPostgres)

Module level documentation

• High level descriptions of modules in README.md