Need new tutorial documentation

[butler]

The old tutorial file is quite dated now and needs a complete rewrite.

[butler]

Starting this task is a core task for code camp IV/release 4.0 … but not necessarily finishing it. Thus not sure whether to mark as blocker or critical? For now going to mark it critical.

[butler]

Moving to blocker to make clear distinction between core tasks (blocker) and related tasks (critical) and important wish lists (major).

[butler]

Upon review, the current tutorial is not as much a tutorial as a more graphical and slightly more detailed user documentation. This should be replaced with proper tutorial documentation which actually takes a user thought the steps to getting actual answers at the end, starting from example data sets loaded with SasView. These should be modular so that tutorials can be added as we go along but also be bundled into a single PDF or HTML for someone who wants to get the whole lot without having to make sure they've downloaded all the individual tutorial modules. This will be an ongoing task so this ticket should be considered complete when a starting list of tutorials needed has been generated and tickets created and at least one tutorial has been completed and builds properly for distribution.

[butler]

Only getting started on this project was part of code camp VI. Having established a plan and the critical items for a release beginning to be urgent, this is now done. Will downgrade to major with the idea that it will move to next release milestone when we are ready for a release.

[butler]

It is clear no more will be done for this release on this ticket so moving to next+1 as suggested earlier.

[smk78]

This ticket is stalled whilst we assess the best technology platform(s) for actually providing the tutorials. Whilst ReST (for Sphinx harmonisation) carries many advantages, from the perspective of those we intend to get to write the tutorials (various SANS instrument team staff) the learning curve is steep and the production overhead (ie, the time spent trying to get content to satisfy ResT/Sphinx/LaTex/MathJax coding rules) is high. Is there anything out there, for example, like Word that generates ReST???

[smk78]

Superseded by #928
Ticket closed.