Cleanup and Comments
  * refactors arn? method out
  * found bug in README
  * adds deprecation comment
  * updates front-end docs to explain ARN