allow facets to be sent at query time
documentation fixes
test cleanup