Improve user documentation

[hflynn]

The current user documentation is not very user-friendly.

Possible improvements:

• add training materials to main user docs
• redo user index page - including clearer divisions between what is nice simple functionality in Omero.insight or Omero.web and the more complex stuff so beginner users aren't put off by looking at advanced stuff, and titles/links which focus on 'how to...'
• better connections between user docs and features page and demo movies
• New overview which really sells what we are doing, and for example, why users should choose omero rather than just using ImageJ etc

[rkferguson]

Happy to help with this if you want to do a joint approach.

[hflynn]

Thanks Gus. I've made you a ticket for getting the training materials into sphinx (#10194) - once this is sorted we should probably have a chat about structuring the index and rewriting the overview.

[agilo]

Updated status, related task in progress

[hflynn]

Training chapters are now replacing out of date tutorials, new index page with more explanation is live, and I've now updated both the 'About Omero' and the 'Features' page on Plone to include more links into the docs. Once @rkferguson updates the Managing Data guide as per the linked task, I'm happy to close this ticket too.

[rkferguson]

Will do this shortly.

[hflynn]

Final task completed, closing ticket as further work will be covered by usual workflow tickets now overhaul is complete.