Docs, examples, readme updated
Some todo's and error messages added to the random functions
Released version 0.12.0