Re: [w3c/browser-payment-api] Editorial changes (#465)

marcoscaceres requested changes on this pull request.



> @@ -119,15 +119,17 @@
       </h2>
       <p>
         This specification describes an API that allows <a>user agents</a>
-        (e.g., browsers) to act as an intermediary between three systems in
-        every transaction: the merchant (e.g., an online web store), the buyer,
-        represented by the <a>user agent</a> (e.g., the user buying from the
-        online web store), and the <dfn data-lt="payment methods">payment
-        method</dfn> (e.g., credit card). Information necessary to process and
-        confirm a transaction is passed between the <a>payment method</a> and
-        the merchant via the <a>user agent</a> with the buyer confirming and
-        authorizing as necessary across the flow.
-      </p>
+        (e.g., browsers) to act as an intermediary between three parties in
+        a transaction:</p>
+
+      <ul>
+ <li>the payee, such as a merchant with an online store,</li>

I'd prefer these ended in full stop. 

> @@ -119,15 +119,17 @@
       </h2>
       <p>
         This specification describes an API that allows <a>user agents</a>
-        (e.g., browsers) to act as an intermediary between three systems in
-        every transaction: the merchant (e.g., an online web store), the buyer,
-        represented by the <a>user agent</a> (e.g., the user buying from the
-        online web store), and the <dfn data-lt="payment methods">payment
-        method</dfn> (e.g., credit card). Information necessary to process and
-        confirm a transaction is passed between the <a>payment method</a> and
-        the merchant via the <a>user agent</a> with the buyer confirming and
-        authorizing as necessary across the flow.
-      </p>
+        (e.g., browsers) to act as an intermediary between three parties in
+        a transaction:</p>
+
+      <ul>
+ <li>the payee, such as a merchant with an online store,</li>

*each of these

>        </p>
+      <ul>
+        <li>the payee, such as a merchant with an online store,

I'd still like this to be:

 * The payee: bla bla bla. 
 * The payer: bla bla bla.
 * The provider: bla bla bla.

  

-- 
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/browser-payment-api/pull/465#pullrequestreview-27988935