rename workspace defs as tab defs
revise docs

new screenshots too