chore(release): harden and document the upgraded workshop