Describe different parts of the security.yml

Add comments for the sections of security.yml in case of the use of AcmeDemoBundle
Original issue: https://github.com/symfony/symfony-standard/issues/676
"[...] the user's password" or "[...] the users' passwords"