@intlayer/docs 5.7.7 → 5.7.8

package/docs/es/CI_CD.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-05-20
-updatedAt: 2025-06-29
+updatedAt: 2025-08-13
 title: Integración CI/CD
-description: Aprende cómo integrar Intlayer en tu pipeline de CI/CD para la gestión y despliegue automatizado de contenido.
+description: Aprende cómo integrar Intlayer en tu pipeline CI/CD para la gestión y despliegue automatizado de contenido.
 keywords:
   - CI/CD
   - Integración Continua
@@ -19,13 +19,13 @@ slugs:
 
 # Generación Automática de Traducciones en un Pipeline CI/CD
 
-Intlayer permite la generación automática de traducciones para tus archivos de declaración de contenido. Existen varias formas de lograr esto dependiendo de tu flujo de trabajo.
+Intlayer permite la generación automática de traducciones para tus archivos de declaración de contenido. Existen múltiples formas de lograr esto dependiendo de tu flujo de trabajo.
 
 ## Uso del CMS
 
-Con Intlayer, puedes adoptar un flujo de trabajo donde solo se declara un único locale localmente, mientras que todas las traducciones se gestionan de forma remota a través del CMS. Esto permite que el contenido y las traducciones estén completamente desacoplados de la base de código, ofreciendo mayor flexibilidad para los editores de contenido y habilitando la recarga dinámica del contenido (sin necesidad de reconstruir la aplicación para aplicar cambios).
+Con Intlayer, puedes adoptar un flujo de trabajo donde solo se declara un único locale localmente, mientras que todas las traducciones se gestionan de forma remota a través del CMS. Esto permite que el contenido y las traducciones estén completamente desacoplados del código base, ofreciendo más flexibilidad para los editores de contenido y habilitando la recarga en caliente del contenido (no es necesario reconstruir la aplicación para aplicar cambios).
 
-### Configuración de ejemplo
+### Configuración de Ejemplo
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -45,7 +45,7 @@ const config: IntlayerConfig = {
     clientSecret: process.env.INTLAYER_CLIENT_SECRET,
   },
   ai: {
-    applicationContext: "This is a test application", // Ayuda a asegurar la generación consistente de traducciones
+    applicationContext: "Esta es una aplicación de prueba", // Ayuda a asegurar una generación consistente de traducciones
   },
 };
 
@@ -58,7 +58,7 @@ Para aprender más sobre el CMS, consulta la [documentación oficial](https://gi
 
 Puedes integrar la generación de traducciones en tu flujo de trabajo local de Git usando [Husky](https://typicode.github.io/husky/).
 
-### Configuración de ejemplo
+### Configuración de Ejemplo
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -66,7 +66,7 @@ import { Locales, type IntlayerConfig } from "intlayer";
 const config: IntlayerConfig = {
   internationalization: {
     locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
-    requiredLocales: [Locales.ENGLISH], // Los locales opcionales se gestionan de forma remota
+    requiredLocales: [Locales.ENGLISH], // Los locales opcionales se manejan de forma remota
     defaultLocale: Locales.ENGLISH,
   },
   editor: {
@@ -77,7 +77,7 @@ const config: IntlayerConfig = {
     provider: "openai",
     apiKey: process.env.OPENAI_API_KEY, // Usa tu propia clave API
 
-    applicationContext: "This is a test application", // Ayuda a asegurar la generación consistente de traducciones
+    applicationContext: "Esta es una aplicación de prueba", // Ayuda a asegurar una generación consistente de traducciones
   },
 };
 
@@ -91,7 +91,7 @@ npx intlayer fill --unpushed --mode fill    # Solo rellena el contenido faltante
 
 > Para más información sobre los comandos CLI de Intlayer y su uso, consulta la [documentación CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md).
 
-> Si tienes múltiples aplicaciones en tu repositorio usando instancias separadas de Intlayer, puedes usar el argumento `--base-dir` así:
+> Si tienes múltiples aplicaciones en tu repositorio usando instancias separadas de Intlayer, puedes usar el argumento `--base-dir` de esta manera:
 
 ```bash fileName=".husky/pre-push"
 # App 1
@@ -105,68 +105,94 @@ npx intlayer fill --base-dir ./app2 --unpushed --mode fill
 
 ## Uso de GitHub Actions
 
-Intlayer proporciona un comando CLI para auto-rellenar y revisar el contenido del diccionario. Esto puede integrarse en tu flujo de trabajo CI/CD usando GitHub Actions.
+Intlayer proporciona un comando CLI para rellenar automáticamente y revisar el contenido del diccionario. Esto se puede integrar en tu flujo de trabajo CI/CD usando GitHub Actions.
 
 ```yaml fileName=".github/workflows/intlayer-translate.yml"
-name: Auto-Relleno Intlayer
+name: Relleno Automático de Intlayer
+# Condiciones para activar este flujo de trabajo
 on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'src/**'
   pull_request:
-    branches: [ main ]
-    paths:
-      - 'src/**'
-  workflow_dispatch: {}
+    branches:
+      - "main"
+
+permissions:
+  contents: write
+  pull-requests: write
 
 concurrency:
-  group: 'autofill-${{ github.ref }}'
+  group: "autofill-${{ github.ref }}"
   cancel-in-progress: true
 
 jobs:
   autofill:
     runs-on: ubuntu-latest
     env:
-      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
-      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      # OpenAI
+      AI_MODEL: openai
+      AI_PROVIDER: gpt-5-mini
+      AI_API_KEY: ${{ secrets.AI_API_KEY }}
 
     steps:
+      # Paso 1: Obtener el código más reciente del repositorio
       - name: ⬇️ Clonar repositorio
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
-          persist-credentials: true
+          persist-credentials: true # Mantener credenciales para crear PRs
+          fetch-depth: 0 # Obtener todo el historial git para análisis de diferencias
 
+      # Paso 2: Configurar el entorno de Node.js
       - name: 🟢 Configurar Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 20 # Usar Node.js 20 LTS para estabilidad
 
+      # Paso 3: Instalar dependencias del proyecto
       - name: 📦 Instalar dependencias
-        run: npm ci
+        run: npm install
+
+      # Paso 4: Instalar Intlayer CLI globalmente para gestión de traducciones
+      - name: 📦 Instalar Intlayer
+        run: npm install -g intlayer-cli
 
+      # Paso 5: Construir el proyecto Intlayer para generar archivos de traducción
       - name: ⚙️ Construir proyecto Intlayer
         run: npx intlayer build
 
-      - name: 🤖 Auto-rellenar traducciones faltantes
-        run: npx intlayer fill --git-diff --mode fill
-
-      - name: 📤 Crear o actualizar PR de traducción
-        uses: peter-evans/create-pull-request@v4
-        with:
-          commit-message: chore: auto-rellenar traducciones faltantes [skip ci]
-          branch: auto-translations
-          title: chore: actualizar traducciones faltantes
-          labels: translation, automated
+      # Paso 6: Usar IA para rellenar automáticamente las traducciones faltantes
+      - name: 🤖 Rellenar automáticamente las traducciones faltantes
+        run: npx intlayer fill --git-diff --mode fill --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY
+
+      # Paso 7: Verificar si hay cambios y confirmarlos
+      - name: � Verificar cambios
+        id: check-changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has-changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has-changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      # Paso 8: Confirmar y enviar cambios si existen
+      - name: 📤 Confirmar y enviar cambios
+        if: steps.check-changes.outputs.has-changes == 'true'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add .
+          git commit -m "chore: auto-fill missing translations [skip ci]"
+          git push origin HEAD:${{ github.head_ref }}
 ```
 
-> Igual que con Husky, en el caso de un monorepo, puedes usar el argumento `--base-dir` para tratar secuencialmente cada aplicación.
+Para configurar las variables de entorno, vaya a GitHub → Configuración → Secrets and variables → Actions y agregue el secreto .
+
+> Al igual que con Husky, en el caso de un monorepo, puede usar el argumento `--base-dir` para tratar secuencialmente cada aplicación.
 
 > Por defecto, el argumento `--git-diff` filtra los diccionarios que incluyen cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
 
-> Para más información sobre los comandos de la CLI de Intlayer y su uso, consulta la [documentación de la CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md).
+> Para más información sobre los comandos de Intlayer CLI y su uso, consulte la [documentación del CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md).
 
 ## Historial del documento
 
-- 5.5.10 - 2025-06-29: Historial inicial
+| Versión | Fecha      | Cambios           |
+| ------- | ---------- | ----------------- |
+| 5.5.10  | 2025-06-29 | Historial inicial |

package/docs/hi/CI_CD.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-05-20
-updatedAt: 2025-06-29
+updatedAt: 2025-08-13
 title: CI/CD एकीकरण
-description: स्वचालित सामग्री प्रबंधन और परिनियोजन के लिए अपने CI/CD पाइपलाइन में Intlayer को एकीकृत करना सीखें।
+description: स्वचालित सामग्री प्रबंधन और परिनियोजन के लिए Intlayer को अपने CI/CD पाइपलाइन में एकीकृत करना सीखें।
 keywords:
   - CI/CD
   - सतत एकीकरण
@@ -19,13 +19,13 @@ slugs:
 
 # CI/CD पाइपलाइन में स्वचालित अनुवाद उत्पन्न करें
 
-Intlayer आपको अपनी सामग्री घोषणा फ़ाइलों के लिए अनुवादों को स्वचालित रूप से उत्पन्न करने की अनुमति देता है। आपके कार्यप्रवाह के आधार पर इसे प्राप्त करने के कई तरीके हैं।
+Intlayer आपके सामग्री घोषणा फ़ाइलों के लिए अनुवादों का स्वचालित उत्पादन करने की अनुमति देता है। आपके कार्यप्रवाह के आधार पर इसे प्राप्त करने के कई तरीके हैं।
 
 ## CMS का उपयोग करना
 
-Intlayer के साथ, आप एक ऐसा कार्यप्रवाह अपना सकते हैं जहाँ केवल एक ही स्थानीय भाषा स्थानीय रूप से घोषित की जाती है, जबकि सभी अनुवाद CMS के माध्यम से दूरस्थ रूप से प्रबंधित किए जाते हैं। इससे सामग्री और अनुवाद पूरी तरह से कोडबेस से अलग हो जाते हैं, जो सामग्री संपादकों के लिए अधिक लचीलापन प्रदान करता है और हॉट कंटेंट रीलोडिंग सक्षम करता है (परिवर्तन लागू करने के लिए एप्लिकेशन को पुनर्निर्माण करने की आवश्यकता नहीं होती)।
+Intlayer के साथ, आप एक ऐसा कार्यप्रवाह अपना सकते हैं जहाँ केवल एक ही स्थानीय भाषा स्थानीय रूप से घोषित की जाती है, जबकि सभी अनुवाद CMS के माध्यम से दूरस्थ रूप से प्रबंधित किए जाते हैं। यह सामग्री और अनुवादों को कोडबेस से पूरी तरह से अलग करने की अनुमति देता है, जिससे सामग्री संपादकों के लिए अधिक लचीलापन मिलता है और हॉट कंटेंट रीलोडिंग सक्षम होती है (परिवर्तन लागू करने के लिए एप्लिकेशन को पुनः निर्माण करने की आवश्यकता नहीं होती)।
 
-### उदाहरण कॉन्फ़िगरेशन
+### उदाहरण विन्यास
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -41,11 +41,11 @@ const config: IntlayerConfig = {
 
     applicationURL: process.env.APPLICATION_URL, // CMS द्वारा उपयोग किया जाने वाला एप्लिकेशन URL
 
-    clientId: process.env.INTLAYER_CLIENT_ID, // CMS क्रेडेंशियल्स
+    clientId: process.env.INTLAYER_CLIENT_ID, // CMS प्रमाणपत्र
     clientSecret: process.env.INTLAYER_CLIENT_SECRET,
   },
   ai: {
-    applicationContext: "This is a test application", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+    applicationContext: "यह एक परीक्षण एप्लिकेशन है", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हों
   },
 };
 
@@ -56,9 +56,9 @@ CMS के बारे में अधिक जानने के लिए,
 
 ## Husky का उपयोग करना
 
-आप [Husky](https://typicode.github.io/husky/) का उपयोग करके अपने स्थानीय Git वर्कफ़्लो में अनुवाद उत्पादन को एकीकृत कर सकते हैं।
+आप अपने स्थानीय Git वर्कफ़्लो में अनुवाद निर्माण को [Husky](https://typicode.github.io/husky/) का उपयोग करके एकीकृत कर सकते हैं।
 
-### उदाहरण कॉन्फ़िगरेशन
+### उदाहरण विन्यास
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -66,7 +66,7 @@ import { Locales, type IntlayerConfig } from "intlayer";
 const config: IntlayerConfig = {
   internationalization: {
     locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
-    requiredLocales: [Locales.ENGLISH], // वैकल्पिक भाषाओं को दूरस्थ रूप से संभाला जाता है
+    requiredLocales: [Locales.ENGLISH], // वैकल्पिक लोकल दूरस्थ रूप से संभाले जाते हैं
     defaultLocale: Locales.ENGLISH,
   },
   editor: {
@@ -75,9 +75,9 @@ const config: IntlayerConfig = {
   },
   ai: {
     provider: "openai",
-    apiKey: process.env.OPENAI_API_KEY, // अपना API कुंजी उपयोग करें
+    apiKey: process.env.OPENAI_API_KEY, // अपना स्वयं का API कुंजी उपयोग करें
 
-    applicationContext: "This is a test application", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+    applicationContext: "यह एक परीक्षण एप्लिकेशन है", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हों
   },
 };
 
@@ -108,61 +108,84 @@ npx intlayer fill --base-dir ./app2 --unpushed --mode fill
 Intlayer एक CLI कमांड प्रदान करता है जो शब्दकोश सामग्री को स्वचालित रूप से भरने और समीक्षा करने के लिए है। इसे GitHub Actions का उपयोग करके आपके CI/CD वर्कफ़्लो में एकीकृत किया जा सकता है।
 
 ```yaml fileName=".github/workflows/intlayer-translate.yml"
-name: Intlayer Auto-Fill
+name: Intlayer ऑटो-फिल
+# इस वर्कफ़्लो के लिए ट्रिगर शर्तें
 on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'src/**'
   pull_request:
-    branches: [ main ]
-    paths:
-      - 'src/**'
-  workflow_dispatch: {}
+    branches:
+      - "main"
+
+permissions:
+  contents: write
+  pull-requests: write
 
 concurrency:
-  group: 'autofill-${{ github.ref }}'
+  group: "autofill-${{ github.ref }}"
   cancel-in-progress: true
 
 jobs:
   autofill:
     runs-on: ubuntu-latest
     env:
-      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
-      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      # OpenAI
+      AI_MODEL: openai
+      AI_PROVIDER: gpt-5-mini
+      AI_API_KEY: ${{ secrets.AI_API_KEY }}
 
     steps:
+      # चरण 1: रिपॉजिटरी से नवीनतम कोड प्राप्त करें
       - name: ⬇️ रिपॉजिटरी चेकआउट करें
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
-          persist-credentials: true
+          persist-credentials: true # PRs बनाने के लिए क्रेडेंशियल्स रखें
+          fetch-depth: 0 # डिफ़ एनालिसिस के लिए पूरी गिट हिस्ट्री प्राप्त करें
 
-      - name: 🟢 Node.js सेटअप करें
-        uses: actions/setup-node@v3
+      # चरण 2: Node.js पर्यावरण सेट करें
+      - name: 🟢 Node.js सेट करें
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 20 # स्थिरता के लिए Node.js 20 LTS का उपयोग करें
+
+      # चरण 3: प्रोजेक्ट निर्भरताएँ इंस्टॉल करें
+      - name: 📦 निर्भरताएँ इंस्टॉल करें
+        run: npm install
 
-      - name: 📦 निर्भरताएँ स्थापित करें
-        run: npm ci
+      # चरण 4: अनुवाद प्रबंधन के लिए Intlayer CLI को ग्लोबली इंस्टॉल करें
+      - name: 📦 Intlayer इंस्टॉल करें
+        run: npm install -g intlayer-cli
 
+      # चरण 5: अनुवाद फ़ाइलें उत्पन्न करने के लिए Intlayer प्रोजेक्ट बनाएं
       - name: ⚙️ Intlayer प्रोजेक्ट बनाएं
         run: npx intlayer build
 
+      # चरण 6: AI का उपयोग करके स्वचालित रूप से गायब अनुवाद भरें
       - name: 🤖 गायब अनुवादों को स्वचालित रूप से भरें
-        run: npx intlayer fill --git-diff --mode fill
-
-      - name: 📤 अनुवाद PR बनाएं या अपडेट करें
-        uses: peter-evans/create-pull-request@v4
-        with:
-          commit-message: chore: स्वचालित रूप से गायब अनुवाद भरें [skip ci]
-          branch: auto-translations
-          title: chore: गायब अनुवाद अपडेट करें
-          labels: translation, automated
-
+        run: npx intlayer fill --git-diff --mode fill --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY
+
+      # चरण 7: जांचें कि क्या कोई परिवर्तन हैं और उन्हें कमिट करें
+      - name: � परिवर्तनों के लिए जांच करें
+        id: check-changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has-changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has-changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      # चरण 8: यदि कोई परिवर्तन हैं तो उन्हें कमिट और पुश करें
+      - name: 📤 परिवर्तन कमिट और पुश करें
+        if: steps.check-changes.outputs.has-changes == 'true'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add .
+          git commit -m "chore: गायब अनुवादों को स्वचालित रूप से भरें [skip ci]"
+          git push origin HEAD:${{ github.head_ref }}
 ```
 
-> हस्की के लिए जैसा है, मोनोरिपो के मामले में, आप प्रत्येक ऐप को क्रमिक रूप से संसाधित करने के लिए `--base-dir` तर्क का उपयोग कर सकते हैं।
+पर्यावरण चर सेट करने के लिए, GitHub → Settings → Secrets and variables → Actions पर जाएं और सीक्रेट जोड़ें।
+
+> Husky के समान, मोनोरिपो के मामले में, आप प्रत्येक ऐप को क्रमिक रूप से संसाधित करने के लिए `--base-dir` तर्क का उपयोग कर सकते हैं।
 
 > डिफ़ॉल्ट रूप से, `--git-diff` तर्क उन शब्दकोशों को फ़िल्टर करता है जिनमें बेस (डिफ़ॉल्ट `origin/main`) से वर्तमान शाखा (डिफ़ॉल्ट: `HEAD`) तक के परिवर्तन शामिल होते हैं।
 
@@ -170,4 +193,6 @@ jobs:
 
 ## दस्तावेज़ इतिहास
 
-- 5.5.10 - 2025-06-29: इतिहास प्रारंभ किया गया
+| संस्करण | दिनांक     | परिवर्तन            |
+| ------- | ---------- | ------------------- |
+| 5.5.10  | 2025-06-29 | इतिहास प्रारंभ करें |

package/docs/it/CI_CD.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-05-20
-updatedAt: 2025-06-29
+updatedAt: 2025-08-13
 title: Integrazione CI/CD
-description: Scopri come integrare Intlayer nella tua pipeline CI/CD per la gestione e il deployment automatico dei contenuti.
+description: Scopri come integrare Intlayer nella tua pipeline CI/CD per la gestione e il deployment automatizzato dei contenuti.
 keywords:
   - CI/CD
   - Integrazione Continua
@@ -19,13 +19,13 @@ slugs:
 
 # Generazione Automatica delle Traduzioni in una Pipeline CI/CD
 
-Intlayer consente la generazione automatica delle traduzioni per i tuoi file di dichiarazione dei contenuti. Ci sono diversi modi per ottenere questo risultato a seconda del tuo flusso di lavoro.
+Intlayer consente la generazione automatica delle traduzioni per i tuoi file di dichiarazione dei contenuti. Ci sono diversi modi per raggiungere questo obiettivo a seconda del tuo flusso di lavoro.
 
 ## Utilizzo del CMS
 
-Con Intlayer, puoi adottare un flusso di lavoro in cui viene dichiarata localmente una sola lingua, mentre tutte le traduzioni sono gestite da remoto tramite il CMS. Questo permette che i contenuti e le traduzioni siano completamente separati dal codice, offrendo maggiore flessibilità agli editor di contenuti e abilitando il caricamento dinamico dei contenuti (senza necessità di ricostruire l'applicazione per applicare le modifiche).
+Con Intlayer, puoi adottare un flusso di lavoro in cui viene dichiarata localmente una sola lingua, mentre tutte le traduzioni sono gestite da remoto tramite il CMS. Questo permette che contenuti e traduzioni siano completamente separati dal codice, offrendo maggiore flessibilità agli editor di contenuti e abilitando il caricamento dinamico dei contenuti (senza bisogno di ricostruire l'applicazione per applicare le modifiche).
 
-### Configurazione di esempio
+### Configurazione di Esempio
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -58,7 +58,7 @@ Per saperne di più sul CMS, consulta la [documentazione ufficiale](https://gith
 
 Puoi integrare la generazione delle traduzioni nel tuo flusso di lavoro Git locale usando [Husky](https://typicode.github.io/husky/).
 
-### Configurazione di esempio
+### Configurazione di Esempio
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -91,7 +91,7 @@ npx intlayer fill --unpushed --mode fill    # Riempie solo i contenuti mancanti,
 
 > Per maggiori informazioni sui comandi CLI di Intlayer e sul loro utilizzo, consulta la [documentazione CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
 
-> Se hai più app nel tuo repository che utilizzano istanze intlayer separate, puoi usare l'argomento `--base-dir` in questo modo:
+> Se hai più app nel tuo repository che utilizzano istanze separate di Intlayer, puoi usare l'argomento `--base-dir` in questo modo:
 
 ```bash fileName=".husky/pre-push"
 # App 1
@@ -103,70 +103,96 @@ npx intlayer build --base-dir ./app2
 npx intlayer fill --base-dir ./app2 --unpushed --mode fill
 ```
 
-## Uso di GitHub Actions
+## Utilizzo di GitHub Actions
 
 Intlayer fornisce un comando CLI per l'autocompletamento e la revisione del contenuto del dizionario. Questo può essere integrato nel tuo flusso di lavoro CI/CD utilizzando GitHub Actions.
 
 ```yaml fileName=".github/workflows/intlayer-translate.yml"
-name: Intlayer Auto-Fill
+name: Compilazione Automatica Intlayer
+# Condizioni di attivazione per questo workflow
 on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'src/**'
   pull_request:
-    branches: [ main ]
-    paths:
-      - 'src/**'
-  workflow_dispatch: {}
+    branches:
+      - "main"
+
+permissions:
+  contents: write
+  pull-requests: write
 
 concurrency:
-  group: 'autofill-${{ github.ref }}'
+  group: "autofill-${{ github.ref }}"
   cancel-in-progress: true
 
 jobs:
   autofill:
     runs-on: ubuntu-latest
     env:
-      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
-      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      # OpenAI
+      AI_MODEL: openai
+      AI_PROVIDER: gpt-5-mini
+      AI_API_KEY: ${{ secrets.AI_API_KEY }}
 
     steps:
+      # Passo 1: Recupera l'ultima versione del codice dal repository
       - name: ⬇️ Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
-          persist-credentials: true
+          persist-credentials: true # Mantieni le credenziali per la creazione delle PR
+          fetch-depth: 0 # Ottieni tutta la cronologia git per l'analisi delle differenze
 
+      # Passo 2: Configura l'ambiente Node.js
       - name: 🟢 Configura Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 20 # Usa Node.js 20 LTS per stabilità
+
+      # Passo 3: Installa le dipendenze del progetto
+      - name: 📦 Installa dipendenze
+        run: npm install
 
-      - name: 📦 Installa le dipendenze
-        run: npm ci
+      # Passo 4: Installa globalmente Intlayer CLI per la gestione delle traduzioni
+      - name: 📦 Installa Intlayer
+        run: npm install -g intlayer-cli
 
-      - name: ⚙️ Compila il progetto Intlayer
+      # Passo 5: Compila il progetto Intlayer per generare i file di traduzione
+      - name: ⚙️ Compila progetto Intlayer
         run: npx intlayer build
 
+      # Passo 6: Usa l'IA per compilare automaticamente le traduzioni mancanti
       - name: 🤖 Compila automaticamente le traduzioni mancanti
-        run: npx intlayer fill --git-diff --mode fill
-
-      - name: 📤 Crea o aggiorna la PR di traduzione
-        uses: peter-evans/create-pull-request@v4
-        with:
-          commit-message: chore: auto-fill missing translations [skip ci]
-          branch: auto-translations
-          title: chore: update missing translations
-          labels: translation, automated
+        run: npx intlayer fill --git-diff --mode fill --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY
+
+      # Passo 7: Controlla se ci sono modifiche e committale
+      - name: � Controlla modifiche
+        id: check-changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has-changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has-changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      # Passo 8: Commit e push delle modifiche se presenti
+      - name: 📤 Commit e push delle modifiche
+        if: steps.check-changes.outputs.has-changes == 'true'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add .
+          git commit -m "chore: compila automaticamente le traduzioni mancanti [skip ci]"
+          git push origin HEAD:${{ github.head_ref }}
 ```
 
-> Come per Husky, nel caso di un monorepo, puoi utilizzare l'argomento `--base-dir` per trattare sequenzialmente ogni app.
+Per configurare le variabili d'ambiente, vai su GitHub → Impostazioni → Segreti e variabili → Azioni e aggiungi il segreto .
+
+> Come per Husky, nel caso di un monorepo, puoi usare l'argomento `--base-dir` per trattare sequenzialmente ogni app.
 
-> Per impostazione predefinita, l'argomento `--git-diff` filtra i dizionari che includono modifiche dalla base (default `origin/main`) al branch corrente (default: `HEAD`).
+> Per impostazione predefinita, l'argomento `--git-diff` filtra i dizionari che includono modifiche dalla base (default `origin/main`) al ramo corrente (default: `HEAD`).
 
 > Per maggiori informazioni sui comandi CLI di Intlayer e sul loro utilizzo, consulta la [documentazione CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
 
-## Cronologia della Documentazione
+## Cronologia del documento
 
-- 5.5.10 - 2025-06-29: Inizio cronologia
+| Versione | Data       | Modifiche                 |
+| -------- | ---------- | ------------------------- |
+| 5.5.10   | 2025-06-29 | Inizializza la cronologia |