Changed documentation to favor constructor injection over setter injection.

The breakout box named "Constructor-based or setter-based DI?" now
recommends to use constructor injection. See the changed section for why.

Issue: SPR-11459.