update the API docs to reflect the change in the case of the /index/search reposnse

and add a note to indicate why (Closes #2601)

@vieux ?