Advanced search: review existing and update developer docs

The following discussion from !202220 (merged) should be addressed:

• @terrichu started a discussion: (+2 comments)

  suggestion (non-blocking): would you mind updating the developer documentation with this filter? I leave as non-blocking so it doesn't block this MR, but would be nice to do as a quick follow up