* igorw/more-docs:
  [docs] a section about common pitfalls
  [docs] style adjustment
  [docs] emphasis on "let's go"
  [docs] explain the purpose of the JsonUserPersister
  [docs] add cross-references to Symfony2 API docs
  [docs] several small adjustments