editorial: expand upon redactList (#841)

Author: rvm4

index.html

@@ -2904,9 +2904,28 @@ 
         <p>
           The steps to <dfn>create a <code>PaymentAddresscode> from
           user-provided inputdfn> are given by the following algorithm. The
-          algorithm takes a <a>lista> <var>redactListvar>, for which user
-          input will not be gathered.
+          algorithm takes a <a>lista> <var>redactListvar>.
         p>
+        <div class="note" title=
+        "Privacy of recipient information (the redactList)">
+          <p>
+            The <var>redactListvar> optionally gives user agents the
+            possibility to limit the amount of personal information about the
+            recipient that the API shares with the merchant.
+          p>
+          <p>
+            For merchants, the resulting <a>PaymentAddressa> object provides
+            enough information to, for example, calculate shipping costs, but,
+            in most cases, not enough information to physically locate and
+            uniquely identify the recipient.
+          p>
+          <p>
+            Unfortunately, even with the <var>redactListvar>, recipient
+            anonymity cannot be assured. This is because in some countries
+            postal codes are so fine-grained that they can uniquely identify a
+            recipient.
+          p>
+        div>
         <ol data-link-for="AddressInit">
           <li>Let <var>detailsvar> be an <a>AddressInita> dictionary with
           no members present.
@@ -4319,28 +4338,9 @@ 
             <a>Queue a taska> on the <a>user interaction task sourcea> to
             run the following steps:
             <ol>
-              <li>
-                <div class="note" title="Privacy of recipient information">
-                  <p>
-                    The <var>redactListvar> optionally gives user agents the
-                    possibility to limit the amount of personal information
-                    about the recipient that the API shares with the merchant.
-                  p>
-                  <p>
-                    For merchants, the resulting <a>PaymentAddressa> object
-                    provides enough information to, for example, calculate
-                    shipping costs, but, in most cases, not enough information
-                    to physically locate and uniquely identify the recipient.
-                  p>
-                  <p>
-                    Unfortunately, even with the <var>redactListvar>,
-                    recipient anonymity cannot be assured. This is because in
-                    some countries postal codes are so fine-grained that they
-                    can uniquely identify a recipient.
-                  p>
-                div>Let <var>redactListvar> be the empty list. Optionally,
-                set <var>redactListvar> to « "organization", "phone",
-                "recipient", "addressLine" ».
+              <li>Let <var>redactListvar> be the empty list. Optionally, set
+              <var>redactListvar> to « "organization", "phone", "recipient",
+              "addressLine" ».
               li>
               <li>Let <var>addressvar> be the result of running the steps to
               <a>create a <code>PaymentAddresscode> from user-provided