Fix some improperly indented doc comments
In the docs, specify when a method can also return nil (besides its usual types)
Use Yard's @raise tag to document exception raises
Use Yard's @see tag when appropriate
Finish tests for Random (fix #27)
Fix Random#boolean and Random#coin to always use the correct random generator