improved workspace document and session spec