Apply suggestions from code review

Co-Authored-By: David Négrier <[email protected]>

CONTRIBUTING.md

@@ -38,9 +38,9 @@ $ php ./safe.php generate
 
 ## Special cases
 
-In some cases, automatic generation is to difficult to execute and the function has to be written manually.
+In some cases, automatic generation is too difficult to execute and the function has to be written manually.
 This should however only be done exceptionally in order to keep the project easy to maintain.
-The most important example are all the functions of the classes DateTime and DateTimeImmutable, since the entire classes have to be overloaded.
+The most important examples are all the functions of the classes `DateTime` and `DateTimeImmutable`, since the entire classes have to be overloaded manually.
 All custom objects must be located in lib/ and custom functions must be in lib/special_cases.php.
 
 ### Submitting a PR

README.md

@@ -59,8 +59,8 @@ $content = file_get_contents('foobar.json');
 $foobar = json_decode($content);
 ```
 
-All PHP functions that can return 'false' on error are part of Safe. 
-In addition, Safe also provide 2 'Safe' classes: Safe\DateTime and Safe\DateTimeImmutable whose methods will throw exceptions instead of returning false.
+All PHP functions that can return `false` on error are part of Safe. 
+In addition, Safe also provide 2 'Safe' classes: `Safe\DateTime` and `Safe\DateTimeImmutable` whose methods will throw exceptions instead of returning false.
 
 ## PHPStan integration
 

lib/DateTime.php

@@ -7,7 +7,7 @@
 use DateTimeZone;
 use Safe\Exceptions\DatetimeException;
 
-//this class is used to implement a safe version of the Datetime
+/** this class implements a safe version of the Datetime class */
 class DateTime extends \DateTime
 {
     //switch from regular datetime to safe version