[TASK] Clean up workspaces manual

Cleaned up the workspaces manual, replaced all images by figure directives, improved some wording, adding cross-links to official documentation.