documentation revisions
simplify the filtered obj to not require request & params and associated testing