Documentation fixes and updates

[woodsp-ibm]

Summary

Main change is to document the (minumum)eigensolvers on the main page along with all the other algorithms now the short forms import the new primitive based algorithms.

At the same time I tried to fixup the navigation index on the left by altering titles and making things consistent in terms of headings etc.

I also edited text where it seems outdated - e.g. it now states upfront about primitives rather than have it repeat everywhere (before there were quantum instance based algos intermixed with primitive based ones so it was needed at that point - with the former removed now from this repo it just looked like a lot of repetition though).

I also put the algorithm groups in alphabetic order, they were pretty much, but.... - time evolvers was where evolvers once was and out of order. Hence it looks like quite a bit more change than it really is.

Details and comments

I marked it [WIP] since I do not consider the fixes/changes quite finished yet. The changes so far can be checked out in the CI docs artifacts which are built. Update: WIP removed.

FYI: The makefile change I did in #33 to support make clean/clean_sphinx to work I did not replicate here - so far I have resorted to manually deleting stubs and build to ensure it builds clean locally.

[coveralls]

Pull Request Test Coverage Report for Build 5879479626

• 3 of 3 (100.0%) changed or added relevant lines in 3 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 89.947%

---

Totals
Change from base Build 5868912123:	0.0%
Covered Lines:	6451
Relevant Lines:	7172

---

💛 - Coveralls

[woodsp-ibm]

I looked over it again and tweaked a few bits. I think for the present it's done so I removed the [WIP] and On Hold. I know #33 I added algorithms_globals to the main init that I changed here - I am thinking there should not be a conflict though (hopefully!)

[ElePT]

Thanks a lot for this PR, I added a few suggestions that in my opinion help clarify some of the text.

[ElePT]

LGTM, I think it's ok not to include the link to the primitive docs, I am expecting the primitive docs to be substantially revamped anyway, so we would probably have to change it soon.

[woodsp-ibm]

I think it's ok not to include the link to the primitive docs, I am expecting the primitive docs to be substantially revamped anyway, so we would probably have to change it soon.

Though I made that long comment about how I had considered link(s) when I did the update I merged the suggestion with the link in it. So the link is there now - but as you say it can be changed later. I figured as long as the docs were overall in better shape, which was the main intent of the update here for me, improvements can always be done in the future.