Tracking pull-request for workshopper@1 conversion

Work in progress.

Lots of code documentation to describe what's going on.