#1197 modifying readme and adding documentation