workshop docs (pass 4)