document Searchable class
add @throws to search() method documentation