add map example to documentation
Merge branch 'master' into documentation
update docs...
clean up tests
Add documentation for map, flatMap, join, collect
add caveat to API section
Merge pull request #2 from karansag/documentation

Documentation, cleaning up tests