issue #51 added captions for figures

w3c · Oct 21, 2024 · 6be7161 · 6be7161
1 parent c6a4f5b
commit 6be7161
Show file tree

Hide file tree

Showing 3 changed files with 58 additions and 27 deletions.
diff --git a/voice interaction drafts/paArchitecture/paArchitecture-1-3.htm b/voice interaction drafts/paArchitecture/paArchitecture-1-3.htm
@@ -23,7 +23,7 @@ <h2 property="bibo:subtitle" id="subtitle">Architecture and
         <dl>
             <dt>Latest version</dt>
             <dd>
-                Last modified: October 15, 2024 <a
+                Last modified: October 21, 2024 <a
                     href="https://github.com/w3c/voiceinteraction/blob/master/voice%20interaction%20drafts/paArchitecture/paArchitecture-1-3.htm">https://github.com/w3c/voiceinteraction/blob/master/voice%20interaction%20drafts/paArchitecture/paArchitecture-1-3.htm</a>
                 (GitHub repository)
             </dd>
@@ -768,14 +768,14 @@ <h3 id="dialoglayer">
     <div class="figurerow">
         <div class="figurecolumn">
             <figure>
-                <img src="dialog-layer-GenerativeAI.svg" height="auto" />
-                <figcaption>Fig 2 b) Generative AI-based Dialog Layer</figcaption>
+                <img src="dialog-layer-NLU.svg" height="auto" />
+                <figcaption>Fig 2 a) NLU-based Dialog Layer</figcaption>
             </figure>
         </div>
         <div class="figurecolumn">
             <figure>
-                <img src="dialog-layer-NLU.svg" height="auto" />
-                <figcaption>Fig 2 a) NLU-based Dialog Layer</figcaption>
+                <img src="dialog-layer-GenerativeAI.svg" height="auto" />
+                <figcaption>Fig 2 b) Generative AI-based Dialog Layer</figcaption>
             </figure>
         </div>
     </div>

diff --git a/voice interaction drafts/paInterfaces/IPAData-Processing-Chain.svg b/voice interaction drafts/paInterfaces/IPAData-Processing-Chain.svg
diff --git a/voice interaction drafts/paInterfaces/paInterfaces.htm b/voice interaction drafts/paInterfaces/paInterfaces.htm
@@ -23,7 +23,7 @@ <h2 property="bibo:subtitle" id="subtitle">Intelligent
         <dl>
             <dt>Latest version</dt>
             <dd>
-                Last modified: October 15, 2024 <a
+                Last modified: October 17, 2024 <a
                     href="https://github.com/w3c/voiceinteraction/blob/master/voice%20interaction%20drafts/paInterfaces/paInterfaces.htm">https://github.com/w3c/voiceinteraction/blob/master/voice%20interaction%20drafts/paInterfaces/paInterfaces.htm</a>
                 (GitHub repository)<br /> <a
                     href="https://w3c.github.io/voiceinteraction/voice%20interaction%20drafts/paInterfaces/paInterfaces.htm">HTML
@@ -291,8 +291,11 @@ <h2 id="main-use-cases">
         </tr>
     </table>
     <p>These main use cases are shown in the following figure</p>
-    <img src="Main-IPA-Use-Cases.svg" alt="Main IPA Use Cases"
+    <figure>
+        <img src="Main-IPA-Use-Cases.svg" alt="Main IPA Use Cases"
         style="width: 40%; height: auto;" />
+        <figcaption>Fig. 1 Main IPA Use Cases</figcaption>
+    </figure>
 
     <p>Not all components may be needed for actual implementations,
         some may be omitted completely. Especially, LLM-based
@@ -313,13 +316,19 @@ <h2 id="main-use-cases">
         shifted to other layers as needed. This view only reflects a
         view that the Community Group regard as ideal and to show the
         intended separation of concerns.</p>
-    <img src="IPA-Major-Components.svg" alt="IPA Major Components"
-        style="width: 50%; height: auto;" />
+    <figure>
+        <img src="IPA-Major-Components.svg" alt="IPA Major Components"
+            style="width: 50%; height: auto;" />
+        <figcaption>Fig. 2 IPA Major Components</figcaption>
+    </figure>
 
     <p>According to these components they are assigned to the
         packages shown below.</p>
-    <img src="IPA-Package-Hierarchy.svg" alt="IPA Package Hierarchy"
-        style="width: 50%; height: auto;" />
+    <figure>
+        <img src="IPA-Package-Hierarchy.svg" alt="IPA Package Hierarchy"
+            style="width: 30%; height: auto;" />
+        <figcaption>Fig. 3 IPA Package Hierarchy</figcaption>
+    </figure>
 
     <h2 id="component-chaining">
         <span class="secno">3.3 </span>Component Chaining
@@ -330,21 +339,39 @@ <h2 id="component-chaining">
         them. This means that the output of one component is the input
         of the next component. Therefore, we introduced the concept of
         an <b>IPADataProcessor</b> that may receive <b>IPAData</b> from
-        incoming <b>IPADataProcessors</b> and forwards <b>IPAData</b>
-        to outgoing <b>IPADataProcessor</b>. The classes for the major components are shown in the
-        following figure.
+        incoming <b>IPADataProcessors</b> and forwards <b>IPAData</b> to
+        outgoing <b>IPADataProcessor</b>. The classes for the major
+        components are shown in the figure 4 a.
     </p>
-    <img src="IPADataProcessors.svg" alt="IPA Data Processors"
-        style="width: 50%; height: auto;" />
-
-    <p>Actual implementations may link them together as needed. An example is
-        shown in the following figure. For example, The IPADatProcessor Client
-        forwards the IPAData MultimodalInputs to the next IPADataProcessor
-        IPAService.</p>
-    <img src="IPAData-Processing-Chain.svg" alt="IPA Data Processing Chain"
-        style="width: 50%; height: auto;" />
+    <div class="figurerow">
+        <div class="figurecolumn">
+            <figure>
+                <img src="IPADataProcessors.svg" alt="IPA Data Processors"
+                    style="width: 70%; height: auto;" />
+                <figcaption>Fig 4 a) IPA Data Processor Examples</figcaption>
+            </figure>
+        </div>
+        <div class="figurecolumn">
+            <figure>
+                <img src="IPAData-Processing-Chain.svg" alt="IPA Data Processing Chain"
+                    style="width: 70%; height: auto;" />
+                <figcaption>Fig 4 b) Example IPADatat Processing Chain</figcaption>
+            </figure>
+        </div>
+    </div>
+    <p>Actual implementations may link them together as needed. An
+        example is shown in figure 4 b. In this example
+        four IPADataProcessors are shown: Client, IPAService,
+        ProviderSelectionService, and DialogManager. In the actual
+        chain, IPAService and Client appear twice, once in the beginning
+        and once in the end of the chain. This chain is then used to
+        hand IPAData, generated in the beginning of the chain towards
+        the end. For example, The IPADatProcessor Client generates the
+        IPAData MultimodalInputs. In this example it is expected to
+        contain only data for the single modality text. This is
+        forwarded to the next IPADataProcessor IPAService for further
+        processing.</p>
 
-    <h2 id="clientlayer">
     <h1 id="highlevelinterfaces">
         <span class="secno">4. </span>High Level Interfaces
     </h1>
@@ -372,9 +399,12 @@ <h1 id="highlevelinterfaces">
 
     <p>A typical flow for the high level interfaces is shown in the
         following figure.</p>
-    <img src="Major-Components-Interaction.svg"
-        alt="IPA Major Components Interaction"
-        style="width: 100%; height: auto;" />
+    <figure>
+        <img src="Major-Components-Interaction.svg"
+            alt="IPA Major Components Interaction"
+            style="width: 50%; height: auto;" />
+        <figcaption>Fig. 5 IPA Major Component Interaction</figcaption>
+    </figure>
     <p>This sequence supports the major use cases stated
         <a href="#main-use-cases">above</a>.</p>