move `search` fns to own section and add documentation