added 'File' to API documentation
made examples downloadable as per Shantenu's suggestion
updated project description according to Shantenu's suggestion.
Update README.md

fixes #2