security update
improved documentation through comments in code
updated documentation (README.md)