Address ogerchikov@ feedback

Author: majido

scroll-animations-1/Overview.bs

@@ -268,8 +268,8 @@ Typically, the scroll bar provides this visual indication but
 applications may wish to hide the scroll bar for aesthetic or useability
 reasons.
 
-Using the 'animation-timeline' property, this example could be written
-as follows:
+Using the updated 'animation' shorthand that includes 'animation-timeline', 
+this example could be written as follows:
 
 <pre class='lang-css'>
 @media (prefers-reduced-motion: no-preference) {
@@ -285,15 +285,12 @@ as follows:
     width: 0px;
     height: 30px;
     background: red;
-    animation: progress 1s linear;
-    animation-fill-mode: forwards;
-    animation-timeline: progress-timeline;
+    animation: 1s linear forwards progress progress-timeline;
   }
-
-
 }
 </pre>
 
+
 If we use this API for this case, the example code will be as follow:
 
 <pre class='lang-javascript'>
@@ -625,11 +622,19 @@ In this case, each possible value of type <<keyframes-name>> from
     {{DocumentTimeline}}, more specifically the <a>default document
     timeline</a>.
 
-Note: Notice that the behavior for the case when no timeline with given name was
-found is different for either property. This ensures backward compatibility
-since most existing animations which have 'animation-name' specified expect to
-use <a>default document timeline</a>.
+Note: Notice that the behavior for the case where no timeline with the given
+name is found is different for these two properties. This ensures backward
+compatibility because all existing time-based animations with 'animation-name'
+specified expect to use <a>default document timeline</a>.
+
+### Changes to the 'animation' shorthand property ### {#animation-shorthand}
+
+The 'animation' shorthand property syntax is updated to accept an additional
+optional <<timeline-name>>.
+
+	<dfn>&lt;single-animation></dfn> = <<time>> || <<easing-function>> || <<time>> || <<single-animation-iteration-count>> || <<single-animation-direction>> || <<single-animation-fill-mode>> || <<single-animation-play-state>> || [ none | <<keyframes-name>> ] || [ none | <<timeline-name>> ]
 
+Issue: Update css-animations spec instead of monkey-patching it here.
 
 ## The '@timeline' at-rule ## {#timeline-at-rule}
 
@@ -691,8 +696,12 @@ have the following effects:
 'scroll-source' descriptor determines the scroll timeline's {{source}}. If
 specified as an '<selector()>' the scroll timeline's {{source}} is the
 [=scroll container=] identified by the <<id-selector>>, otherwise if not
-specified or none then it is the animation target's nearest scrollable ancestor.
+specified or none then it is the the {{scrollingElement}} of the {{Document}} 
+<a lt="document associated with a window">associated</a> with the {{Window}}
+that is the <a>current global object</a>.
 
+Issue(4338): consider choosing animation target's nearest scrollable ancestor
+instead of document's scrolling Element
 
 <pre class='descdef'>
   Name: scroll-orientation