updated docs
created db and table objects.  also began returning error conditions