added some jsdoc comments and standardized some formatting
add why section to README