Improve docs on `prefer_sigils`

[elbrujohalcon]

No "Rationale", no "Correct code", no "Avoid code"? 😄 At least that consistency we could maintain, right?

Originally posted by @paulo-ferraz-oliveira in #599 (comment)