Change to Markdown for the README and clean up the text.
Separated out random() wrapper to it's own module
fixed a bug with random number generation