[1.7.x] Removed confusing paragraph from the docs.

This snippet wasn't particularly helpful as `add_error()` is described
in greater details in the following section.

Thanks Claude Paroz for the report.

Backport of f1f0c4f16b from master