refs #10034. Add doc tests and description

This algorithm was completely missing any usage examples. Description has also been updated. Included quite a large discussion on alias vs copy in python as well as some examples.
Merge branch 'feature/10034_clone_workspace' into develop