[w3c/uievents] 'Key value' terminology is ambiguous and confusing (#117)

2. Keyboard Event key Value Tables
https://w3c.github.io/uievents-key/#key-value-tables

I found it very hard to get to grips with the text about keyboard events in the three specs uievents, uievents-key and uievents-code because it seemed that the two words 'key' and 'value' were juxtaposed to mean more than one possible thing.

One suggestion would be to refer to the KeyboardEvent.key values defined explicitly in uievents-key using a specially defined term such as 'functionally-defined values', or 'reserved values', or some such term that clearly indicates what they are and looks like a technical term.

Actually https://w3c.github.io/uievents-code/#functional-key contains a definition for 'functional keys' that might work(?)

A side benefit of this would be that you could then talk about 'printable characters' as being the set of character produced by keys that are not within the set of functionally-defined values.

Another example of this is in 
https://w3c.github.io/uievents/#events-keyboardevents

where the definition of KeyboardEvent . key says

> key holds the key value of the key pressed

Does that just mean 'the value produced by the key', or is it referring to the technical term 'key value' ?

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/uievents/issues/117