docs: update Crowdin AI (#296)

Author: rohalskyy

src/assets/screenshots/crowdin/translation-process/crowdin_ai_editor.png

@@ -61,6 +61,7 @@ To configure AI prompts, follow these steps:
           * Previous and next strings – allows AI to consider previous and next strings for additional context.
           * File context – allows AI to consider a textual description of the file added in the [file settings](/file-management/#file-context) or in the [Editor](/online-editor/#file-context).
           * AI-Generated Context &ndash; automatically generate file context when it's missing. If the file context isn’t provided manually, AI will analyze the source content and generate a contextual summary. This summary is used both during pre-translation and as reference material in the Editor. <Aside type="caution">This option is only available in file-based projects and requires the File context option to be enabled.</Aside>
+          * File content (Specific to the AI in editor prompt type) &ndash; allows AI to access the full file content during chat communication with the AI Assistant. The file content is added to context only when requested by AI.
           * Screenshots &ndash; allows AI to consider a visual context in the form of screenshots where the strings are tagged. This enhances accuracy and context awareness. <ReadMore>Read more about [Screenshots](/screenshots/).</ReadMore>
           * Public project description &ndash; allows AI to consider public project description.
           * Custom placeholders &ndash; select reusable placeholders previously created in your Crowdin account's AI settings from a drop-down menu to quickly insert standard text snippets into your prompt.
@@ -340,23 +341,26 @@ Pre-translation via AI allows you to use AI Models to pre-translate your content
 
 ## Using AI in the Editor
 
-After configuring a prompt with the **AI in editor** type, Crowdin AI can be used in the Editor as an AI Assistant for translators and proofreaders. This AI Assistant can be communicated with in a chat format, allowing you to send prompts and receive replies.
+After configuring a prompt with the **AI in editor** type, Crowdin AI can be used in the Editor as an AI Assistant for translators and proofreaders. The AI Assistant works in a chat format, allowing you to send prompts and receive replies.
 
-The AI Assistant is context-aware, meaning it knows the string the translator is working on, the related glossaries, TM matches, the maximum acceptable length of the translation, the related screenshots, etc. This contextual awareness enables the AI Assistant to provide more accurate and relevant assistance.
+The AI Assistant is context-aware, meaning it automatically considers the string the translator is working on, the related glossaries, TM matches, the maximum acceptable length of the translation, the related screenshots, and more. This contextual awareness enables the AI Assistant to provide more accurate and relevant assistance.
 
 Here are some tasks the AI Assistant can help with:
 
-* Correcting TM suggestions: If you get a 60% match, the AI Assistant can improve the remaining 40%, ensuring consistency with your terminology and previous translations.
-* Serving as an advanced dictionary: The AI Assistant can provide term definitions, translation variants, synonyms, and more.
-* Suggesting translations: Similar to other MT tools, the AI Assistant can suggest translations which you can further refine based on your specific needs or save as is.
+* **Correcting TM suggestions** - If you get a 60% match, the AI Assistant can improve the remaining 40%, ensuring consistency with your terminology and previous translations.
+* **Serving as an advanced dictionary** - The AI Assistant can provide term definitions, translation variants, synonyms, and more.
+* **Suggesting translations** - Similar to other MT tools, the AI Assistant can suggest translations that you can refine based on your specific needs or save as is.
+* **Summarizing content** – For example, when translating knowledge base articles, it can generate short summaries to help you understand the content before translating.
 
-In addition, the AI Assistant can help in translating knowledge base articles by providing short summaries, helping you grasp the content quickly before translating.
+To start using the AI Assistant, click the **AI Assistant** section in the right sidebar of the Editor.
 
-When working in the Editor, you can start using the AI Assistant by clicking the AI Assistant tab in the right sidebar.
+You can also interact with the AI Assistant faster using context-aware shortcuts. When you hover over an AI, TM, or MT suggestion in the Context and Translations section, the **Discuss suggestion with AI** button appears. Click it to open the chat with the suggestion already prefilled.
+
+To see what context is passed to the AI, click the <Icon name="mdi:information-outline" class="inline-icon" />**Show AI context** button in the AI Assistant panel header. This opens a modal that displays the full scope of context available to the AI, including the selected string, TM matches, glossary terms, file name, surrounding strings, filtered strings, project description, plural forms, and more.
 
 <Image src={aiEditor} alt="AI Assistant in the Editor" />
 
-For faster and more efficient interaction with the AI Assistant, you can use prompt shortcuts. By default, there are three prompt shortcuts available:
+For even faster and more efficient interaction with the AI Assistant, you can use prompt shortcuts. By default, three prompt shortcuts are available:
 
 * Rephrase
 * Shorten
@@ -367,7 +371,7 @@ To add your own prompt shortcuts, follow these steps:
 <Steps>
   1. Click <Icon name="mdi:cog" class="inline-icon"/> in the upper-right corner to open the AI settings.
   2. Click <Icon name="mdi:plus" class="inline-icon"/> **Add shortcut**.
-  3. Specify a shortcut name and a prompt it will be using.
+  3. Specify a shortcut name and a prompt it will use.
   4. Click **Save**.
 </Steps>
 

src/content/docs/crowdin/translation-process/crowdin-ai.mdx

@@ -61,6 +61,7 @@ To configure AI prompts, follow these steps:
           * Previous and next strings – allows AI to consider previous and next strings for additional context.
           * File context – allows AI to consider a textual description of the file added in the [file settings](/enterprise/file-management/#file-context) or in the [Editor](/enterprise/online-editor/#file-context).
           * AI-Generated Context &ndash; automatically generate file context when it's missing. If the file context isn’t provided manually, AI will analyze the source content and generate a contextual summary. This summary is used both during pre-translation and as reference material in the Editor. <Aside type="caution">This option is only available in file-based projects and requires the File context option to be enabled.</Aside>
+          * File content (Specific to the AI in editor prompt type) &ndash; allows AI to access the full file content during chat communication with the AI Assistant. The file content is added to context only when requested by AI.
           * Screenshots &ndash; allows AI to consider a visual context in the form of screenshots where the strings are tagged. This enhances accuracy and context awareness. <ReadMore>Read more about [Screenshots](/enterprise/screenshots/).</ReadMore>
           * Public project description &ndash; allows AI to consider public project description.
           * Custom placeholders &ndash; select reusable placeholders previously created in the organization's AI settings from a drop-down menu to quickly insert standard text snippets into your prompt.
@@ -344,23 +345,26 @@ Pre-translation via AI allows you to use AI Models to pre-translate your content
 
 ## Using AI in the Editor
 
-After configuring a prompt with the **AI in editor** type, Crowdin AI can be used in the Editor as an AI Assistant for translators and proofreaders. This AI Assistant can be communicated with in a chat format, allowing you to send prompts and receive replies.
+After configuring a prompt with the **AI in editor** type, Crowdin AI can be used in the Editor as an AI Assistant for translators and proofreaders. The AI Assistant works in a chat format, allowing you to send prompts and receive replies.
 
-The AI Assistant is context-aware, meaning it knows the string the translator is working on, the related glossaries, TM matches, the maximum acceptable length of the translation, the related screenshots, etc. This contextual awareness enables the AI Assistant to provide more accurate and relevant assistance.
+The AI Assistant is context-aware, meaning it automatically considers the string the translator is working on, the related glossaries, TM matches, the maximum acceptable length of the translation, the related screenshots, and more. This contextual awareness enables the AI Assistant to provide more accurate and relevant assistance.
 
 Here are some tasks the AI Assistant can help with:
 
-* Correcting TM suggestions: If you get a 60% match, the AI Assistant can improve the remaining 40%, ensuring consistency with your terminology and previous translations.
-* Serving as an advanced dictionary: The AI Assistant can provide term definitions, translation variants, synonyms, and more.
-* Suggesting translations: Similar to other MT tools, the AI Assistant can suggest translations which you can further refine based on your specific needs or save as is.
+* **Correcting TM suggestions** - If you get a 60% match, the AI Assistant can improve the remaining 40%, ensuring consistency with your terminology and previous translations.
+* **Serving as an advanced dictionary** - The AI Assistant can provide term definitions, translation variants, synonyms, and more.
+* **Suggesting translations** - Similar to other MT tools, the AI Assistant can suggest translations that you can refine based on your specific needs or save as is.
+* **Summarizing content** – For example, when translating knowledge base articles, it can generate short summaries to help you understand the content before translating.
 
-In addition, the AI Assistant can help in translating knowledge base articles by providing short summaries, helping you grasp the content quickly before translating.
+To start using the AI Assistant, click the **AI Assistant** section in the right sidebar of the Editor.
 
-When working in the Editor, you can start using the AI Assistant by clicking the AI Assistant tab in the right sidebar.
+You can also interact with the AI Assistant faster using context-aware shortcuts. When you hover over an AI, TM, or MT suggestion in the Context and Translations section, the **Discuss suggestion with AI** button appears. Click it to open the chat with the suggestion already prefilled.
+
+To see what context is passed to the AI, click the <Icon name="mdi:information-outline" class="inline-icon" />**Show AI context** button in the AI Assistant panel header. This opens a modal that displays the full scope of context available to the AI, including the selected string, TM matches, glossary terms, file name, surrounding strings, filtered strings, project description, plural forms, and more.
 
 <Image src={aiEditor} alt="AI Assistant in the Editor" />
 
-For faster and more efficient interaction with the AI Assistant, you can use prompt shortcuts. By default, there are three prompt shortcuts available:
+For even faster and more efficient interaction with the AI Assistant, you can use prompt shortcuts. By default, three prompt shortcuts are available:
 
 * Rephrase
 * Shorten
@@ -371,7 +375,7 @@ To add your own prompt shortcuts, follow these steps:
 <Steps>
   1. Click <Icon name="mdi:cog" class="inline-icon"/> in the upper-right corner to open the AI settings.
   2. Click <Icon name="mdi:plus" class="inline-icon"/> **Add shortcut**.
-  3. Specify a shortcut name and a prompt it will be using.
+  3. Specify a shortcut name and a prompt it will use.
   4. Click **Save**.
 </Steps>