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.
The last sentence isn't necessary, is it? If you really want to make it more clear, you could write something like:

> [...] if the output is error output (``true`` is passed) or not.