Apply suggestions from code review

Co-authored-by: Timmy Willison <[email protected]>

Author: mgol

entries/jQuery.Deferred.exceptionHook.xml

@@ -7,10 +7,10 @@
   <desc>Handle errors produced by Deferreds.</desc>
   <longdesc>
     <p>This API is called every time an error is thrown inside Deferreds. By default, it only warns about errors that are more likely to be programmer errors than errors thrown due to application logic. This includes errors like <code>SyntaxError</code> or <code>ReferenceError</code>.</p>
-    <p>If you want, you can redefine the API to handle errors the way you like. The function accepts two parameters - the first one is an error thrown and the second, optional one is a "fake" error created before the handler is called so that a stack trace from before an async barrier is available. This second error is only provided if <a href="/jQuery.Deferred.getErrorHook/"><code>jQuery.Deferred.getErrorHook</code></a> is defined; see the docs for that API for more details.</p>
+    <p>The function accepts two parameters - the first one is the error thrown and the second, optional parameter is a "fake" error created before the handler is called so that a stack trace from before an async barrier is available. This second error is only provided if <a href="/jQuery.Deferred.getErrorHook/"><code>jQuery.Deferred.getErrorHook</code></a> is defined; see the docs for that API for more details.</p>
     <h3>Example</h3>
     <pre><code><![CDATA[
-// These usually indicate a programmer mistake during development,
+// These usually indicate a programmer mistake during development;
 // warn about them ASAP rather than swallowing them by default.
 var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
 

entries/jQuery.Deferred.getErrorHook.xml

@@ -7,7 +7,7 @@
   <desc>Return an Error instance with a defined stack.</desc>
   <longdesc>
     <div class="warning">
-      <p>Note: This API is not defined by default. It may be provided by the user and jQuery will then use it internally.</p>
+      <p>Note: This API is not defined by default, but jQuery will make use of it when defined.</p>
     </div>
     <p>When <code>jQuery.Deferred.getErrorHook</code> is defined, it extends the <code>jQuery.Deferred</code> features added in jQuery 3.0 to include an error captured before the async barrier whenever a Deferred throws an exception. This makes it easier to find programming errors that occur inside Deferreds. You can find an example implementation you can copy-paste below, or you can use <a href="https://github.com/dmethvin/jquery-deferred-reporter">jquery-deferred-reporter</a> plugin.</p>
     <pre><code>