Tweaks after proofreading the 2.6 OptionsResolver stuff

Hi guys!

This is a proofread after merging #4159. There were enough changes there that the easiest way to handle things was to merge, re-read entirely, then open a PR with small tweaks. But largely, I am very happy with how the document turned out :).

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | 2.6+
| Fixed tickets | --

Thanks!
Unfortunately, and much to my dismay, Symfony project has recently decided to stop writing beautifully aligned code (see https://github.com/symfony/symfony/issues/12284). Should we apply this practice to the code displayed in the documentation?