Added documentation about the DebugFormatter helper

| Q   | A
| --- | ---
| Doc fix? | no
| New docs? | yes (symfony/symfony#10627)
| Applies to | 2.6+
| Fixed tickets | #4256 

When may want to add screenshots to the article, but to get this ready quick before 2.6 is released stable, I left them out now.
Well, I personally feel like `true` is a success, so using `true` to indicate an error message was quite surprising for me, that's why I've added the sentence explicitely.