more docs; make `SearchOptions` easier to import