Adding information about pluralization into documentation

Relating to #247 #391 #247 #127 #392
this class name must match the class name used in the PHP code example.

And it would be great to display the inflector implementation first, as you will generally create it before defining a service using it