add double workspace; clean up documentation comments