workshop docs (pass 3)