Project: Hands-on tutorials extension

[cpinter]

Draft Status

Ready - team will start page creating immediately

Category

IGT and Training

Key Investigators

• Alejandro Rodríguez Moreno (Ebatinca SL, Spain)
• Csaba Pinter (Ebatinca SL, Spain)
• Interested people welcome! (Andriy, Tina, Andras?)

Project Description

Unfortunately the issue of useful and up-to-date tutorials is quite difficult, because

• Slide-based tutorials need to be updated manually (see that many tutorials are pre-5.0 in the training material)
• Video tutorials are impossible to update
• In the above two cases it is next to impossible to offer them in different languages
• In-repo markdown files are quite limited in format and usefulness

We have developed a tutorials infrastructure and some basic tutorials for a commercial project, which could be repurposed for Slicer core. Basically it consists of a curriculum that is described by a JSON file, with dependencies among the tutorials, and a set of hands-on tutorials that can be started from this home screen.

The hands-on tutorials guide the users through a certan sequence of steps using targeted tooltips and a mechanism detecting if the current step has been completed successfully. This way we could offer some basic tutorials for Slicer core in multiple languages, which is easier to maintain than the current modalities. Of course maintenance will remain an issue, because if API changes the tutorials will break, but the basic functions of Slicer has not really changed in the last decade, and hopefully there won't be much maintenance necessary.

Objective

1. Objective A: Reach a common understanding about the necessity of this in general
2. Objective B: Get started with the extension

Approach and Plan

1. Discuss the proposal, hopefully in a breakout session, but in any case involving the interested people
   a. Decide if the basics are sensible, feasible, and useful, or not
   b. Define an initial set of tutorials
2. Start to adapt the tutorials infrastructure to the proposed goals

Progress and Next Steps

1. Describe specific steps you have actually done.

Illustrations

Part of the curriculum tree in the commercial app that we propose to adapt to Slicer core

Background and References

• The commercial app in question: https://ebatinca.com/productos/start
• The current training material for Slicer core: https://training.slicer.org/