diff --git a/css-nesting-1/Overview.bs b/css-nesting-1/Overview.bs index 192c91a36ee..313f1342231 100644 --- a/css-nesting-1/Overview.bs +++ b/css-nesting-1/Overview.bs @@ -873,6 +873,15 @@ Mixing Nesting Rules and Declarations {#mixing} before "Order Of Appearance" comes into consideration. + Note: While one can freely intermix declarations and nested rules, + it's harder to read and somewhat confusing to do so, + since all the properties act as if they came before all the rules. + For readability's sake, + it's recommended that authors put all their properties first in a style rule, + before any nested rules. + (This also happens to act slightly better in older user agents, + due to specifics of how parsing and error-recovery work.) +