diff --git a/sample/payments/CreatePayment.php b/sample/payments/CreatePayment.php
index ccbfa76..5c17c7e 100644
--- a/sample/payments/CreatePayment.php
+++ b/sample/payments/CreatePayment.php
@@ -81,8 +81,8 @@ $payment->setIntent("sale")
 	->setTransactions(array($transaction));
 
 // ### Create Payment
-// Create a payment by posting to the APIService
-// using a valid ApiContext (See bootstrap.php for more on `ApiContext`)
+// Create a payment by calling the payment->create() method
+// with a valid ApiContext (See bootstrap.php for more on `ApiContext`)
 // The return object contains the state.
 try {
 	$payment->create($apiContext);
diff --git a/sample/source/CreatePayment.html b/sample/source/CreatePayment.html
index e3f1073..e1c57d2 100644
--- a/sample/source/CreatePayment.html
+++ b/sample/source/CreatePayment.html
@@ -60,8 +60,8 @@ the above types and intent set to sale 'sale'</p></div></div><div class="code"><
   <span class="o">-&gt;</span><span class="na">setPayer</span><span class="p">(</span><span class="nv">$payer</span><span class="p">)</span>
   <span class="o">-&gt;</span><span class="na">setTransactions</span><span class="p">(</span><span class="k">array</span><span class="p">(</span><span class="nv">$transaction</span><span class="p">));</span></div></div></div><div class="segment"><div class="comments"><div class="wrapper"><h3 id="create-payment">Create Payment</h3>
 
-<p>Create a payment by posting to the APIService
-using a valid ApiContext (See bootstrap.php for more on <code>ApiContext</code>)
+<p>Create a payment by calling the payment->create() method
+with a valid ApiContext (See bootstrap.php for more on <code>ApiContext</code>)
 The return object contains the state.</p></div></div><div class="code"><div class="wrapper"><span class="k">try</span> <span class="p">{</span>
   <span class="nv">$payment</span><span class="o">-&gt;</span><span class="na">create</span><span class="p">(</span><span class="nv">$apiContext</span><span class="p">);</span>
 <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="nx">PayPal\Exception\PPConnectionException</span> <span class="nv">$ex</span><span class="p">)</span> <span class="p">{</span>
@@ -82,4 +82,4 @@ The return object contains the state.</p></div></div><div class="code"><div clas
 <span class="x">  &lt;pre&gt;</span><span class="cp">&lt;?php</span> <span class="nb">var_dump</span><span class="p">(</span><span class="nv">$payment</span><span class="o">-&gt;</span><span class="na">toArray</span><span class="p">());</span><span class="cp">?&gt;</span><span class="x">&lt;/pre&gt;</span>
 <span class="x">  &lt;a href=&#39;../index.html&#39;&gt;Back&lt;/a&gt;</span>
 <span class="x">&lt;/body&gt;</span>
-<span class="x">&lt;/html&gt;</span></div></div></div></div></body></html>
\ No newline at end of file
+<span class="x">&lt;/html&gt;</span></div></div></div></div></body></html>
diff --git a/sample/source/DeleteCreditCard.html b/sample/source/DeleteCreditCard.html
index c66e287..37de6d7 100644
--- a/sample/source/DeleteCreditCard.html
+++ b/sample/source/DeleteCreditCard.html
@@ -31,7 +31,7 @@ an 'id' that you can use to refer to it later.
 
 <span class="k">try</span> <span class="p">{</span></div></div></div><div class="segment"><div class="comments"><div class="wrapper"><h3 id="delete-card">Delete Card</h3>
 
-<p>deletes saved credit card
+<p>Lookup and delete a saved credit card.
 (See bootstrap.php for more on <code>ApiContext</code>)</p></div></div><div class="code"><div class="wrapper">  <span class="nv">$creditCard</span> <span class="o">=</span> <span class="nx">CreditCard</span><span class="o">::</span><span class="na">get</span><span class="p">(</span><span class="nv">$card</span><span class="o">-&gt;</span><span class="na">getId</span><span class="p">(),</span> <span class="nv">$apiContext</span><span class="p">);</span>
   <span class="nv">$creditCard</span><span class="o">-&gt;</span><span class="na">delete</span><span class="p">(</span><span class="nv">$apiContext</span><span class="p">);</span>
 <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="nx">PayPal\Exception\PPConnectionException</span> <span class="nv">$ex</span><span class="p">)</span> <span class="p">{</span>
@@ -47,4 +47,4 @@ an 'id' that you can use to refer to it later.
 <span class="x">    &lt;p&gt; Credit Card deleted Successfully&lt;/p&gt;</span>
 <span class="x">  &lt;a href=&#39;../index.html&#39;&gt;Back&lt;/a&gt;</span>
 <span class="x">&lt;/body&gt;</span>
-<span class="x">&lt;/html&gt;</span></div></div></div></div></body></html>
\ No newline at end of file
+<span class="x">&lt;/html&gt;</span></div></div></div></div></body></html>
diff --git a/sample/vault/DeleteCreditCard.php b/sample/vault/DeleteCreditCard.php
index 0de5bba..3ba6d0d 100644
--- a/sample/vault/DeleteCreditCard.php
+++ b/sample/vault/DeleteCreditCard.php
@@ -36,7 +36,7 @@ try {
 
 try {
 	// ### Delete Card
-	// deletes saved credit card
+	// Lookup and delete a saved credit card.
 	// (See bootstrap.php for more on `ApiContext`)
 
 	$creditCard = CreditCard::get($card->getId(), $apiContext);