--- a/latest/use-cases/index.html Sat Apr 18 17:34:58 2015 -0400
+++ b/latest/use-cases/index.html Sat Apr 18 20:10:47 2015 -0400
@@ -95,6 +95,9 @@
//respecEvents.sub('start-all', webpayments.preProcess.apply);
</script>
<style type="text/css">
+body {
+ line-height: 1.4em;
+}
h4 {
color: #005A9C;
}
@@ -511,7 +514,7 @@
are accepted by the <a>payee</a>.
</li>
<li>
-<strong>Selection of Payment Instruments</strong>. The <a>payee</a>
+<strong>Selection of Payment Instruments</strong>. The <a>payer</a>
selects one or more <a title="payment instrument">payment instruments</a>
that are available to the <a>payer</a> and are accepted by the
<a>payee</a>.
@@ -542,8 +545,8 @@
party (e.g., bank) initiates processing.
</li>
<li>
-<strong>Verification of Available Funds</strong>. The <a>payee</a> may
-need to provide a proof of funds or a proof of hold to the <a>payer</a>
+<strong>Verification of Available Funds</strong>. The <a>payer</a> may
+need to provide a proof of funds or a proof of hold to the <a>payee</a>
before finalizing payment and delivery of the product.
</li>
<li>
@@ -582,7 +585,7 @@
receipt, digital proof of <a>purchase</a>, encrypted line-item receipt, etc.).
</li>
<li>
-<strong>Refunds</strong>. At time exceptions may occur (e.g., defective
+<strong>Refunds</strong>. At times exceptions may occur (e.g., defective
product, application of store return policy, etc.). In this case, the
<a>payee</a> initiates payment to the <a>payer</a>. The refund may
take different forms, including a refund to the <a title="payer">payer's</a>
@@ -610,11 +613,10 @@
</p>
<p class="issue">
-General feedback is requested as to whether or not this section is helpful in
-grounding the payment phases and steps in a real world use case is helpful this
-early in the document. An alternative would be removing this section
-entirely if the preceding section suffices, or moving this narrative to
-section 7 with other examples.
+General feedback is requested on whether this section is helpful. We are
+attempting to ground the payment phases and steps in a real world use case.
+An alternative would be removing this section entirely if the preceding
+section suffices, or moving this narrative to section 7 with the other examples.
</p>
<section>
@@ -641,8 +643,8 @@
<li>
<strong>Application of Marketing Elements</strong>: As Jill prepares to
-check out, PayToParty offers her a discount of 10% if she uses the store's
-loyalty card to pay.
+check out, PayToParty notifies her of a discount for 10% if she uses
+the store's loyalty card to pay.
</li>
</ul>
</section>
@@ -652,7 +654,7 @@
<ul>
<li>
<strong>Discovery of Accepted Schemes</strong>: Given where Jill lives,
-PayToParty offers her payment by credit card, debit card, the PayToParty
+PayToParty accepts payment by credit card, debit card, the PayToParty
loyalty card, and PayPal, but not Jill's favorite cryptocurrency (which she
uses on other sites).
</li>
@@ -733,7 +735,7 @@
<ul>
<li>
<strong>Connectivity</strong>. Connectivity requirements vary according to
-use case. The types of connections a device may utilize include Internet
+use case. The types of connections a device may use include Internet
connectivity, proxied connections through short-range radio transmissions,
and proximity connections over a technology such as Near-Field Communication
(NFC) or Bluetooth Low Energy (BTLE). Some use cases assume no
@@ -805,9 +807,9 @@
<dl class="dl-horizontal">
<dt>Point of Sale Kiosk</dt>
<dd>
-Cory shops for groceries at his local ChowMart, scans all of the items he
-wants to <a>purchase</a> at the automated kiosk, and is presented with a
-total amount.
+Cory shops for groceries at his local ChowMart, scans his loyalty card and
+all of the items he wants to <a>purchase</a> at the automated kiosk, and is
+presented with a total amount.
</dd>
<dt>Goals</dt>
<dd>
@@ -906,9 +908,10 @@
</dd>
<dt>Motivation</dt>
<dd>
-By design, some <a title="transaction">transactions</a> do not reach
-completion. Some are merely there to protect the <a>payee</a> (e.g., in the
-event of questionable judgment by the <a>payer</a>).
+Some <a title="transaction">transactions</a>, such as a hold of funds,
+do not always reach completion and are primarily used
+to protect the <a>payee</a> from negligence on the part of the
+<a>payer</a> (e.g., such as a <a>payer</a> damaging a hotel room).
</dd>
<dt>Exceptions</dt>
<dd>