added docs for the new Table console helper

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes (symfony/symfony#10365)
| Applies to    | 2.5+
| Fixed tickets | n/a