some basic fixes for search upgrade doc