add filtering documentation from Jim and start removing old docs