workshop docs (pass 2)