I think they're nice because:
- they allow autocompletion,
- magic values are bad (as seen on several other PRs)

Anyway, the current documentation is a bad compromise. If I were you I would pick one or the other way, not a weird mix.