Clarified documentation
Scope information
Note about init
Note about data sharing
More doc changes
Response to CR
Fix some pylint stuff to get the build to pass.
Removed DS_Store files