improve algorithms

Author: gabrielsanbrito

index.bs

@@ -752,7 +752,7 @@ enum AudioContextState {
                 "<dfn>interrupted</dfn>"
             <td>
                 This context is currently interrupted and cannot process audio
-                until the interruption ends.
+                until the [=interruption=] ends.
 </table>
 </div>
 
@@ -1972,37 +1972,36 @@ Methods</h4>
             2. Let <var>promise</var> be a new Promise.
 
             3. If the {{[[control thread state]]}} on the
-                {{AudioContext}} is <code>closed</code> or <code>interrupted</code> reject the
+                {{AudioContext}} is <code>closed</code> reject the
                 promise with {{InvalidStateError}}, abort these steps,
                 returning <var>promise</var>.
 
             4. Set {{[[suspended by user]]}} to <code>false</code>.
 
-            4. If the {{BaseAudioContext/state}} attribute of the {{AudioContext}} is "{{AudioContextState/suspended}}" and the {{[[control thread state]]}} on the
-                {{AudioContext}} is <code>interrupted</code>:
+            5. If the {{[[control thread state]]}} on the
+                {{AudioContext}} is <code>suspended</code> and there is an ongoing [=interruption=]:
+
+                1. Queue a media element task</a> to execute the following steps:
 
-                1. <a href="https://html.spec.whatwg.org/multipage/media.html#queue-a-media-element-task">
-                queue a media element task</a> to execute the following steps:
-                
                     1. Set the {{BaseAudioContext/state}} attribute of the {{AudioContext}} to "{{AudioContextState/interrupted}}".
 
                     2. [=Queue a media element task=] to [=fire an event=] named
                             {{BaseAudioContext/statechange}} at the {{AudioContext}}.
-
+                
                 2. Reject the promise with {{InvalidStateError}}, abort these steps,
                 returning <var>promise</var>.
 
-            5. If the context is not <a>allowed to start</a>, append
+            6. If the context is not <a>allowed to start</a>, append
                 <var>promise</var> to {{BaseAudioContext/[[pending promises]]}} and
                 {{AudioContext/[[pending resume promises]]}} and abort these steps, returning
                 <var>promise</var>.
 
-            6. Set the {{[[control thread state]]}} on the
+            7. Set the {{[[control thread state]]}} on the
                 {{AudioContext}} to <code>running</code>.
 
-            7. <a>Queue a control message</a> to resume the {{AudioContext}} with <var>promise</var>.
+            8. <a>Queue a control message</a> to resume the {{AudioContext}} with <var>promise</var>.
 
-            8. Return <var>promise</var>.
+            9. Return <var>promise</var>.
         </div>
 
         <div id="context-resume" algorithm="run a control message in AudioContext">
@@ -11984,6 +11983,11 @@ buffer</a> and the value(s) of the {{AudioParam}}(s) of this
 
 <h3 id="interruption-handling">Handling an interruption on the {{AudioContext}}</h3>
 
+An <dfn>interruption</dfn> is an event generated by the user agent when it needs to halt audio playback for 
+an {{AudioContext}}. For example, The user agent may create an interruption when another application
+requests exclusive access to the audio output hardware. This could happen when there is an incoming
+call from a VoIP application.
+
 The {{AudioContext}} |audioContext| performs the following steps on the <a>rendering thread</a> when an interruption happens.
 
 1. If the |audioContext|'s {{[[rendering thread state]]}} is <code>closed</code> or <code>interrupted</code>:
@@ -12010,13 +12014,13 @@ The {{AudioContext}} |audioContext| performs the following steps on the <a>rende
 
 Note: If the {{AudioContext}} is <code>suspended</code> a {{BaseAudioContext/statechange}} event is not fired for privacy reasons to avoid over-sharing user activity - e.g. when a phone call comes in or when the screen gets locked.
 
-The {{AudioContext}} |audioContext| performs the following steps on the <a>rendering thread</a> when the interruption ends.
+The {{AudioContext}} |audioContext| performs the following steps on the <a>rendering thread</a> when the [=interruption=] ends.
 
 1. If the |audioContext|'s {{[[rendering thread state]]}} is not <code>interrupted</code>:
 
     1. Abort these steps.
 
-1. If the |audioContext|'s {{[[rendering thread state]]}} was <code>running</code> before the interruption or if the the |audioContext|'s {{[[rendering thread state]]}} was <code>suspended</code> and {{AudioContext/resume}} was called during the interruption:
+1. If the |audioContext|'s {{[[rendering thread state]]}} was <code>running</code> before the [=interruption=] or if the the |audioContext|'s {{[[rendering thread state]]}} was <code>suspended</code> and {{AudioContext/resume}} was called during the [=interruption=]:
 
     1. Attempt to <a href="#acquiring">acquire system resources</a>.
 
@@ -12032,7 +12036,7 @@ The {{AudioContext}} |audioContext| performs the following steps on the <a>rende
 
             1. [=Fire an event=] named {{BaseAudioContext/statechange}} at the |audioContext|.
 
-1. If the |audioContext|'s {{[[rendering thread state]]}} was <code>suspended</code> before the interruption:
+1. If the |audioContext|'s {{[[rendering thread state]]}} was <code>suspended</code> before the [=interruption=]:
 
     1. Set the {{[[rendering thread state]]}} on the {{AudioContext}} to <code>suspended</code>.