added vcs explanation, other edits, fixes #1