PR nits

Author: noamr

css-view-transitions-2/Overview.bs

@@ -117,7 +117,7 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
 	1. Once it's time to [=unload=] the old document, if the navigation is [=same origin=]
 		and the old {{Document}} has opted in to cross-document view-transitions, the old state is captured.
 
-	1. An event named {{ReadyToRenderEvent|readytorender}} is fired on the new {{Document}}, with a `viewTransition` property,
+	1. An event named {{RevealEvent|reveal}} is fired on the new {{Document}}, with a `viewTransition` property,
 		which is a {{ViewTransition}} object. This {{ViewTransition}}'s <code>{{ViewTransition/updateCallbackDone}}</code> is already resolved,
 		and its [=captured elements=] are populated from the old {{Document}}.
 
@@ -136,7 +136,7 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
 
 		```css
 		// in both documents:
-		@view-transition {
+		@view-transition same-origin {
 			trigger: navigation;
 		}
 		```
@@ -152,7 +152,7 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
 
 		- Opt-in to navigation-triggered view-transitions in both pages.
 		- Pass the click location to the new document, e.g. via {{WindowSessionStorage/sessionStorage}}.
-		- Intercept the {{ViewTransition}} object in the new document, using the {{ReadyToRenderEvent}}.
+		- Intercept the {{ViewTransition}} object in the new document, using the {{RevealEvent}}.
 
 		In both pages:
 		```css
@@ -173,7 +173,7 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
 		In the new page:
 		```js
 		// This would run both on initial load and on reactivation from BFCache.
-		addEventListener("readytorender", async event => {
+		addEventListener("reveal", async event => {
 			if (!event.viewTransition)
 				return;
 
@@ -209,20 +209,21 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
 
 # CSS rules # {#css-rules}
 
-## The <dfn id="at-view-transition-rule">''@view-transition''</dfn> rule ## {#view-transition}
+## The <dfn id="at-view-transition-rule">''@view-transition''</dfn> rule ## {#view-transition-rule}
 
 The ''@view-transition'' rule is used by a document to indicate that cross-document navigations
 should setup and activate a {{ViewTransition}}. To take effect, it must be present in the old document
 when unloading, and in the new document when it is [=ready to render=].
 
 
-## @view-transition rule grammar ## {#view-transition-grammer}
+## @view-transition rule grammar ## {#view-transition-grammar}
 
-''@view-transition'' rules are [=CSS/parsed=] according to the following grammar,
-plus the additional rules noted below:
+The ''@view-transition'' rule has the following syntax:
 
 <pre class=prod>
-	@view-transition = @view-transition same-origin { <<declaration-rule-list>> }
+	@view-transition same-origin {
+		<<declaration-rule-list>>
+	}
 </pre>
 
 Note: currently <code>same-origin</code> has to be present, as a future placeholder for customizing
@@ -256,20 +257,20 @@ Note: as per default behavior, the ''@view-transition'' rule can be nested insid
 
 # API # {#api}
 
-## The <dfn interface>ReadyToRenderEvent</dfn> ## {#ready-to-render-event}
+## The <dfn interface>RevealEvent</dfn> ## {#ready-to-render-event}
 
 Note: this should go in the HTML spec. See [Issue 9315](https://github.com/whatwg/html/issues/9315).
 
 <xmp class=idl>
 		[Exposed=Window]
-		interface ReadyToRenderEvent : Event {
+		interface RevealEvent : Event {
 			readonly attribute ViewTransition? viewTransition;
 		};
 </xmp>
 
 Note: this event is fired when the document is [=ready to render=].
 
-The <dfn attribute for=ReadyToRenderEvent>viewTransition</dfn> [=getter steps=] are to return the
+The <dfn attribute for=RevealEvent>viewTransition</dfn> [=getter steps=] are to return the
 [=inbound cross-document view-transition=] for [=this's=] [=relevant global object's=] [=associated document=].
 
 ## Extensions to the <code>CSSRule</code> interface</h3> ## {#extensions-to-cssrule-interface}
@@ -278,7 +279,7 @@ The <code>CSSRule</code> interface is extended as follows:
 
 <pre class='idl'>
 partial interface CSSRule {
-    const unsigned short NAVIGATION_BEHAVIOR_RULE = 15;
+    const unsigned short VIEW_TRANSITION_RULE = 15;
 };
 </pre>
 
@@ -346,8 +347,8 @@ The {{CSSViewTransitionRule}} represents a ''@view-transition'' rule.
 
 		1. If |transition| is not null and |document| does not [=opt in to cross-document view transitions=], then [=skip the view transition|skip=] |transition| and set |transition| to null.
 
-		1. Fire a new event named <code>readytorender</code> on |document|'s [=relevant global object=],
-			using {{ReadyToRenderEvent}}.
+		1. Fire a new event named <code>reveal</code> on |document|'s [=relevant global object=],
+			using {{RevealEvent}}.
 
 		1. If |transition| is not null, then [=activate view transition|activate=] |transition|.