Doc fix to clarify kv property behaviour (fixes #2374)

I hope this makes things clearer?