Clarified Password Encoders example

This replaces #3618

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | no
| Applies to | all
| Ficket tickets | -