Updating comments to better explain what is going on

also added workspace.xml to .gitignore ..