Improving docs about validation

With some questions from our user mailing list
why did you change to `@NotNull` instead of `@NotEmpty`? 
(asking just to know if there are some technical reason  for it)