tables.sql: Add table descriptions
cocked up half done test readability helper

will need to rejigger overall API to return dictionary of various
replacement values..  this will allow for future helpers that get the actual
URL from sites like tinyurl, etc