Improved README

Author: TheJavaGuy

README.md

@@ -1,5 +1,5 @@
 # 1. About rng
-rng is an implementation of several well-known pseudo-random number generators which have far better characteristics than Java's built-in generator.
+rng is an implementation of several well-known pseudo-random number generators which have far better characteristics than Java's built-in generator. rng can be used for simulations, games (dice rolling, shuffling of playing cards etc.) or for any other application where security is not paramount. Specifically, it should **never** be used for cryptographically secure applications. 
 # 2. Features
 Within rng you'll find the following generators (in alphabetical order):
 * [Complementary multiply with carry (CMWC)][gen-cmwc]
@@ -29,8 +29,9 @@ $ mvn clean package -Prng
 $ ls -alF target | grep rng
 ```
 # 4. Usage examples
-Using any of the generators is super easy. You just need to create an object and then request random number in the range you need.
+Using any of the generators is super easy. You just need to create a generator object and then request a random number in the range you need.
 ## 4.1 Instantiating a generator
+Before obtaining pseudo-random numbers, you have to create a generator object:
 ```java
 PRNG.Smart generator = new MersenneTwister.Smart(new MersenneTwister());
 ```
@@ -39,11 +40,12 @@ In a similar way you would instantiate an object for some other generator, e.g.
 PRNG.Smart generator = new XorshiftPlus.Smart(new XorshiftPlus());
 ```
 ## 4.2 Generating an integer in given range
+This is probably the most common operation with the generator. To generate an integer you always have to specify a _range_ (i.e. lower and upper bound of a number):
 ```java
-IntRange range = new IntRange(1, 6);
-int roll = generator.nextInt(range);
+IntRange sixSidedDie = new IntRange(1, 6);
+int dots = generator.nextInt(sixSidedDie);
 ```
-```IntRange``` class is constant (immutable) so you can share it's instances freely.
+This may look a bit verbose, but actually makes your code's intention very explicit. ```IntRange``` class is constant (immutable) so you can share its instances freely.
 ## 4.3 Generating a double in range [0,1)
 ```java
 double number = generator.nextDouble();
@@ -56,13 +58,18 @@ byte colorIndex = generator.nextByte();
 short tetrisScore = generator.nextShort();
 char letter = generator.nextChar();
 ```
-
 # 5. How to contribute
-If you spot an error or you think you can add some feature to rng just fork the project and make a pull request.
+Additional generators can be easily added. There is only one requirement: every generator must implement the ```PRNG``` interface. This interface has only one method ```int nextInt();``` which must return integer in the whole range, i.e. ```[Integer.MIN_VALUE, Integer.MAX_VALUE]```. And that's it! All the heavy lifting afterwards is done automatically by the ```PRNG.Smart``` class. If you know how to implement some other generator or believe there's a bug somewhere, please fork the project, change/add what you want and make a pull request.
 # 6. License
 rng is licensed under [GPLv3][gpl] license.
 # 7. Credits for previous work
-TBD
+I would like to say a big thank you to the following people - authors of generators implemented in rng project:
+* [Complementary multiply with carry (CMWC)][gen-cmwc] George Marsaglia
+* [Mersenne Twister 19937][gen-mt] Makoto Matsumoto and Takuji Nishimura
+* [R250][gen-gfsr] Scott Kirkpatrick and Erich Stoll
+* [R250/521][gen-gfsr] Scott Kirkpatrick and Erich Stoll
+* [Xorshift Plus][gen-xorshiftplus] George Marsaglia
+
 # 8. How to contact author
 If you have a question or issue with rng itself please use [Issues][rngissues] link. If you want to talk about anything else, I'm [@\_The\_Java\_Guy\_][twitterhandle] on Twitter.