improved comments on v2 classes
add comments to v2 classes
improved comments on v2 code

also trialing GitHub on Mac