improved documents and corner case for filters