improved doc about the search