Extending function for common case usege

+ localised descriptions
+ Readme added
Fix in sample code
Fix missed id field
Merge pull request #1 from macik/master

Extending function for common case usage