OPA-5010 Small changes

Author: raducoravu

topics/vibing_with_ai_positron.dita

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
 <topic id="vibing_with_ai_positron">
-    <title>Practical Steps Towards Vibe Writing with AI Positron</title>
+    <title>Practical Steps for Vibe Writing with AI Positron</title>
     <prolog>
         <author>Radu Coravu</author>
         <critdates>
@@ -32,13 +32,12 @@
             <p>If one would attempt to divide people in novices and experts, they would soon figure
                 out that each of us is a <b>novice</b> in certain fields and <b>expert</b> in
                 others. </p>
-            <p>A novice uses out of the box tools and frameworks with a minimum of customization to
-                obtain poor results. They cannot explain either when the tool does not work or when
+            <p>As novices we use out of the box tools and frameworks with a minimum of customization
+                to obtain poor results. We cannot explain either when the tool does not work or when
                 it does. When we do not obtain quality content as novices we blame the tools.</p>
-            <p>In time by <b>reading</b>, <b>writing</b> and <b>making mistakes</b> one evolves to
-                understand the tools and frameworks they use. They realize that taking some time to
-                understand these tools and to customize them gives them better and more consistent
-                results. </p>
+            <p>In time by <b>reading</b>, <b>writing</b> and <b>making mistakes</b> we evolve to
+                understand the tools and frameworks we use. Taking some time to understand these
+                tools and to customize them gives us better and more consistent results. </p>
             <p>This article is an attempt to give you a better understanding about how the <ph
                     keyref="oxygen"/>
                 <uicontrol>AI Positron</uicontrol> add-on works and how it can be customized to
@@ -153,22 +152,31 @@ from the project</codeblock><p>
                     <uicontrol>AI Positron</uicontrol> chat view:<ul id="ul_o4h_kng_2hc">
                     <li>Tools to explore the overall project. The chat modes have access to:<ul
                             id="ul_prx_mng_2hc">
-                            <li>A tool which can perform keyword search in the project, for example
+                            <li>Tool which can perform keyword search in the project, for example
                                 you can ask
                                 it:<codeblock id="codeblock_wv1_4ng_2hc">Find topics about Git Push in the project 
 and give me an overview of the most suitable ones.</codeblock></li>
-                            <li>A tool to grep and perform exact string matches in the project, even
-                                by matching inside specifix XML elements. For
+                            <li>Grep and perform exact string matches in the project, even by
+                                matching inside specifix XML elements. For
                                 example:<codeblock id="codeblock_o14_5ng_2hc">Find places where the Save action is mentioned 
 in DITA &lt;uicontrol> elements.</codeblock></li>
-                            <li>A tool to explore the project folder structure. For
+                            <li>Explore the project folder structure. For
                                 example:<codeblock id="codeblock_mpd_zng_2hc">Where should I save DITA maps in this project?</codeblock></li>
                         </ul></li>
                     <li>Tools to read content from the current or a different file.
                         Example:<codeblock id="codeblock_n5r_f4g_2hc">Give me suggestions about how to shorten the current document
 contents.</codeblock></li>
                     <li>Tools to make large or small changes to the current or to other documents.
                         Examples:<codeblock id="codeblock_bcf_m4g_2hc">Shorten the title of the current document</codeblock>or:<codeblock id="codeblock_ofl_p4g_2hc">Find and fix logical inconsistencies in the current document</codeblock></li>
+                    <li>Tools to provide validation and terminology problems reported for certain
+                        documents. If you have many style guide rules it is advisable to implement
+                        them as <xref href="SchematronBCs.dita">Schematron rules</xref> or rules for
+                        the <ph keyref="oxygen"/>
+                        <xref
+                            href="https://www.oxygenxml.com/doc/ug-addons/topics/terminology-checker-addon.html"
+                            format="html" scope="external">Terminology Checker</xref> add-on. Once
+                        you implement the checks you can simply ask the
+                        AI:<codeblock id="codeblock_d55_b1m_2hc">Fix validation and terminology problems in the generated content before saving it to disk.</codeblock></li>
                     <li>Tools to make XML aware changes in documents:<ul id="ul_ept_r4g_2hc">
                             <li>Apply existing XML refactoring operations on documents.
                                 Example:<codeblock id="codeblock_nqd_t4g_2hc">Invoke XML refactor operation to add unique IDs on all pargraphs</codeblock></li>