[w3c/manifest] "Default display mode" section is super confusing (Issue #1024)

The concept of "default display mode" is very confusing. Is it the mode requested by the app manifest? The mode the UA would have defaulted to if there is no request from an app manifest? The display mode that is actually in effect at the end of the day?

It would be much easier to follow this section if there were two named concepts neither of which use the word "default":
* requested display mode - the mode requested by app manifest
* effective display mode - the mode actually effective on the document after consideration of the app manifest, user preferences/overrides, and UA constraints

(It also needs to be clarified whether the `display-mode` media query reflects the effective display mode, requested display mode, or something else.)

-- 
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/manifest/issues/1024