adding docs
working through formalizing exceptions.
changed SimpleQueryModelBuilder to throw exceptions instead of returning null.