Updating the resource component doc.

| Q             | A
| ------------- | ---
| Fixed tickets | n/a
| License       | MIT

@Sylius: Do we add something about exceptions ?
@winzou should write some lines about states machine later :)