[Console] Add documentation for QuestionHelper

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes (https://github.com/symfony/symfony/pull/10606)
| Applies to    | 2.5+

This is the documentation for the new Question Helper