New search docs

Primary goal of this PR is to clarify the re-indexing documentation for 5.0.3. A good deal of work went in to making the process faster and more surefire. Will a user who's been warned of the need to re-index (via troubleshooting and the release announcement) be able to follow the outlined steps from top to bottom and have a clean&fresh search index? Does any of the terminology need to be further explained? Etc.

Remaining tasks:
 * [ ] Introduce a link to the upcoming metrics docs
 * [ ] Update the nightshade statistics (@kennethgillen)
``Not included are non-string annotations like file annotations which are handled separately (see below).``
sounds a bit clumsy. 
Maybe 
``Non-string annotations like file annotations are not covered by this definition and are handled separately (see below).``