Merge pull request #108 from johnnypeck/patch-1

Clean up readme a bit

Author: dunglas

README.md

@@ -6,21 +6,21 @@ a fully featured PHP data model including:
 * A set of PHP entities with properties, constants (enum values), getters, setters, adders and removers. The class
 hierarchy provided by Schema.org will be translated to a PHP class hierarchy with parents as `abstract` classes. The generated
 code complies with [PSR](http://www.php-fig.org/) coding standards.
-* Full high-quality PHPDoc for classes, properties, constants and methods extracted from Schema.org.
+* Full, high-quality PHPDoc for classes, properties, constants and methods extracted from Schema.org.
 * Doctrine ORM annotation mapping including database columns with type guessing, relations with cardinality guessing, class
 inheritance (through the `@AbstractSuperclass` annotation).
 * Data validation through [Symfony Validator](https://symfony.com/doc/current/book/validation.html) annotations including
 data type validation, enum support (choices) and check for required properties.
 * Interfaces and [Doctrine `ResolveTargetEntityListener`](https://doctrine-orm.readthedocs.org/en/latest/cookbook/resolve-target-entity-listener.html)
 support.
 * Custom PHP namespace support.
-* List of values provided by Schema.org with [PHP Enum](https://github.com/myclabs/php-enum) classes.
+* List of values provided by [Schema.org](https://schema.org) with [PHP Enum](https://github.com/myclabs/php-enum) classes.
 
 Bonus:
 
-* The code generator is fully configurable and extensible: all features can be deactivated (e.g.: the Doctrine mapping generator)
-and custom generator can be added (e.g.: a Doctrine ODM mapping generator).
-* The generated code can be used as is in a [Symfony](http://symfony.com) app (but it will work too in a raw PHP project
+* The code generator is fully configurable and extensible. All features can be deactivated (e.g., the Doctrine mapping generator)
+and a custom generator can be added (e.g., a Doctrine ODM mapping generator).
+* The generated code can be used as is in a [Symfony](https://symfony.com) app (but it will work too in a raw PHP project
 or any other framework including [Laravel](https://laravel.com) and [Zend Framework](http://framework.zend.com/)).
 
 [![Build Status](https://travis-ci.org/api-platform/schema-generator.svg?branch=master)](https://travis-ci.org/api-platform/schema-generator)
@@ -31,27 +31,26 @@ or any other framework including [Laravel](https://laravel.com) and [Zend Framew
 
 Schema.org is a vocabulary representing common data structures and their relations. Schema.org can be exposed as [JSON-LD](https://en.wikipedia.org/wiki/JSON-LD),
 [microdata](https://en.wikipedia.org/wiki/Microdata_(HTML)) and [RDFa](https://en.wikipedia.org/wiki/RDFa).
-Extracting semantical data exposed in the Schema.org vocabulary is supported by a growing number of companies including
+Extracting semantic data exposed in the Schema.org vocabulary is supported by a growing number of companies including
 Google (Search, Gmail), Yahoo!, Bing and Yandex.
 
 ## Why use Schema.org data to generate a PHP model?
 
 ### Don't Reinvent The Wheel
 
-Data models provided by Schema.org are popular and have been proved efficient. They cover a broad spectrum of topics including
+Data models provided by Schema.org are popular and have proved efficient. They cover a broad spectrum of topics including
 creative work, e-commerce, event, medicine, social networking, people, postal address, organization, place or review.
-Schema.org has its root in [a ton of preexisting well designed vocabularies](http://schema.rdfs.org/mappings.html) and is
-successfully used by more and more website and applications.
+Schema.org has its roots in [a ton of preexisting well designed vocabularies](http://schema.rdfs.org/mappings.html) and is
+successfully used by more and more websites and applications.
 
 Pick up schemas applicable to your application, generate your PHP model, then customize and specialize it to fit your needs.
 
 ### Improve SEO and user experience
 
-Adding Schema.org markup to websites and apps increase their ranking in search engines results and enable awesome features
+Adding Schema.org markup to websites and apps may increase their ranking in search engine results and enable awesome features
 such as [Google Rich Snippets](https://support.google.com/webmasters/answer/99170?hl=en) and [Gmail markup](https://developers.google.com/gmail/markup/overview).
 
-Mapping your app data model to Schema.org structures can be a tedious task. Using the generator, your data model will be
-a derived from Schema.org. Adding microdata markup to your templates or serializing your data as JSON-LD will not require
+Mapping your app data model to Schema.org structures can be a tedious task. Using the generator, your data model will be derived from Schema.org. Adding microdata markup to your templates or serializing your data as JSON-LD will not require
 specific mapping nor adaptation. It's a matter of minutes.
 
 ### Be ready for the future
@@ -68,4 +67,4 @@ It opens the way to generic web API clients able to extract and process data fro
 
 ## Credits
 
-This project has been created by [Kévin Dunglas](https://dunglas.fr) and is sponsored by [Les-Tilleuls.coop](https://les-tilleuls.coop).
+This project was created by [Kévin Dunglas](https://dunglas.fr) and is sponsored by [Les-Tilleuls.coop](https://les-tilleuls.coop).