diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 80b6f98038..2d2870bbe6 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -51,7 +51,7 @@ Para añadir una nueva integración desde Slack: - "Instala la integración con HubSpot." - "Configura la integración con Linear." 2. El agente responde con un enlace de autorización. -3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados. +3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados. Después de autorizar, el navegador muestra una página de confirmación que indica que la conexión se ha completado. 4. Vuelve a Slack. El agente confirma la conexión y puede usar inmediatamente la integración como contexto para futuras solicitudes. Las integraciones que conectes desde Slack se aplican al ámbito de tu usuario individual de Slack, por lo que cada miembro del equipo configura sus propias conexiones y el agente usa las conexiones de quien haya enviado el mensaje. Si un usuario de Slack no ha conectado un servicio, el agente recurre a las integraciones a nivel de organización instaladas desde la página [Agent](https://dashboard.mintlify.com/products/agent) en el panel. @@ -60,6 +60,16 @@ Para eliminar o volver a autorizar una integración a nivel de organización, us Para ver la lista completa de servicios admitidos, consulta el [catálogo de toolkits de Composio](https://docs.composio.dev/toolkits). +### Conexiones caducadas o revocadas + +Mintlify mantiene sincronizado el estado de tus servicios conectados con Composio. Una conexión queda desconectada cuando: + +- El proveedor externo expira o revoca las credenciales. +- El proveedor marca la conexión como inactiva. +- Tú eliminas la conexión. + +Si una conexión ya no está activa, la próxima vez que pidas al agente que use ese servicio, responderá con un enlace de autorización. Haz clic en el enlace, vuelve a autorizar el servicio y el agente retomará la conexión. +
## Usar el agente en Slack
@@ -69,7 +79,7 @@ Una vez conectado, puedes: - Enviar mensajes directos al agente para usarlo en privado y actualizar tu documentación. - Mencionar `@mintlify` en un canal para usarlo de forma pública y colaborativa. - Adjuntar archivos e imágenes directamente a tus mensajes para que el agente los procese y los incluya en tu documentación. -- Continuar las conversaciones en hilos para iterar sobre los cambios. +- Continuar las conversaciones en hilos para iterar sobre los cambios o hacer preguntas de seguimiento. El agente reutiliza los archivos e imágenes compartidos previamente en el hilo como contexto para las solicitudes posteriores, por lo que no es necesario que los vuelvas a cargar. - Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada.
@@ -80,7 +90,7 @@ Utiliza el agente para actualizar tu documentación mediante una nueva solicitud - **Nueva solicitud**: Envía un mensaje directo al agente o menciona `@mintlify` en un canal con instrucciones sobre qué actualizar. - **Hilo existente**: Responde en el hilo y menciona `@mintlify` con instrucciones sobre qué actualizar. -- **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. +- **Con archivos adjuntos**: Sube imágenes, diagramas, archivos de código u otros documentos junto con tu mensaje. El agente los procesa automáticamente y los incluye en tu documentación. En un hilo, el agente tiene acceso a las imágenes y archivos compartidos en mensajes anteriores, por lo que puedes hacer referencia a ellos en las solicitudes posteriores sin necesidad de volver a subirlos. El agente lee el contexto de la solicitud o del hilo y crea una solicitud de extracción en tu repositorio conectado con las actualizaciones. diff --git a/es/api-playground/asyncapi-setup.mdx b/es/api-playground/asyncapi-setup.mdx index 9454bbfd6f..516a2fd3ba 100644 --- a/es/api-playground/asyncapi-setup.mdx +++ b/es/api-playground/asyncapi-setup.mdx @@ -109,6 +109,33 @@ Para generar automáticamente páginas para todos los canales de tu esquema Asyn El campo `directory` es opcional. Si no se especifica, Mintlify añade los archivos a la carpeta **api-reference** del repositorio de documentación. +### Ejemplos con grupos anidados + +La propiedad `asyncapi` admite grupos anidados. Mintlify genera las páginas de canal y las añade al grupo anidado, junto con cualquier página existente. + +Esto resulta útil cuando quieres organizar los canales WebSocket como una subsección de un grupo de API más amplio, o cuando necesitas combinar varias especificaciones de AsyncAPI bajo un grupo principal común. + +```json +"navigation": { + "tabs": [ + { + "tab": "API Reference", + "groups": [ + { + "group": "Voice API", + "pages": [ + "voice/overview", + { + "group": "Voice API Commands", + "asyncapi": "/path/to/voice-asyncapi.json" + } + ] + } + ] + } + ] +} +```
## Página de canal diff --git a/es/api/agent/create-agent-job.mdx b/es/api/agent/create-agent-job.mdx index a91c8866a0..f7bb6e7fe8 100644 --- a/es/api/agent/create-agent-job.mdx +++ b/es/api/agent/create-agent-job.mdx @@ -1,8 +1,5 @@ --- title: "Crear trabajo del agente (v1)" -description: "En desuso. Crea un trabajo del agente para automatizar las - actualizaciones de la documentación, con creación automática de branch y - generación de solicitud de extracción." openapi: /es/admin-openapi.json POST /v1/agent/{projectId}/job keywords: [ "trabajo del agente", "crear", "automatización", "automatizar" ] tag: "deprecated" diff --git a/es/api/agent/get-agent-job.mdx b/es/api/agent/get-agent-job.mdx index ceb5147295..3ba4143dab 100644 --- a/es/api/agent/get-agent-job.mdx +++ b/es/api/agent/get-agent-job.mdx @@ -1,8 +1,5 @@ --- title: "Obtener trabajo de agente (v1)" -description: "En desuso. Obtén el estado y los detalles de un trabajo de agente - específico, incluido el progreso, la información de la branch y los detalles - de la solicitud de extracción." openapi: /es/admin-openapi.json GET /v1/agent/{projectId}/job/{id} keywords: [ "trabajo de agente", "estado", "obtener", "detalles" ] tag: "deprecated" diff --git a/es/api/agent/get-all-jobs.mdx b/es/api/agent/get-all-jobs.mdx index f22fd62009..cdcb09f40c 100644 --- a/es/api/agent/get-all-jobs.mdx +++ b/es/api/agent/get-all-jobs.mdx @@ -1,8 +1,5 @@ --- title: "Listar trabajos del agente (v1)" -description: "En desuso. Recupera todos los trabajos del agente de un proyecto - para monitorear actividades y hacer seguimiento del historial de estados de - los trabajos." openapi: /es/admin-openapi.json GET /v1/agent/{projectId}/jobs keywords: [ "trabajos del agente", "listar", "monitoreo" ] tag: "deprecated" diff --git a/es/api/agent/v2/create-agent-job.mdx b/es/api/agent/v2/create-agent-job.mdx index 15db62c0af..2f457c58a8 100644 --- a/es/api/agent/v2/create-agent-job.mdx +++ b/es/api/agent/v2/create-agent-job.mdx @@ -1,7 +1,5 @@ --- title: "Crear tarea de agente" -description: "Crea una tarea de agente que se ejecuta en segundo plano y crea - automáticamente una solicitud de extracción con cambios en la documentación." openapi: /es/admin-openapi.json POST /v2/agent/{projectId}/job keywords: [ "tarea de agente", "crear", "automatización", "automatizar" ] --- diff --git a/es/api/agent/v2/get-agent-job.mdx b/es/api/agent/v2/get-agent-job.mdx index 3761ea9d05..edd234f6ac 100644 --- a/es/api/agent/v2/get-agent-job.mdx +++ b/es/api/agent/v2/get-agent-job.mdx @@ -1,7 +1,5 @@ --- title: "Obtener tarea del agente" -description: "Recupera el estado y los detalles de una tarea del agente, - incluido el progreso y el enlace de la solicitud de extracción." openapi: /es/admin-openapi.json GET /v2/agent/{projectId}/job/{id} keywords: [ diff --git a/es/api/agent/v2/send-message.mdx b/es/api/agent/v2/send-message.mdx index 3b60c9f91c..0cfa8b26ae 100644 --- a/es/api/agent/v2/send-message.mdx +++ b/es/api/agent/v2/send-message.mdx @@ -1,7 +1,5 @@ --- title: "Enviar un mensaje de seguimiento" -description: "Envía un mensaje de seguimiento a una tarea de agente existente - para proporcionar instrucciones adicionales." openapi: /es/admin-openapi.json POST /v2/agent/{projectId}/job/{id}/message keywords: [ "tarea de agente", "mensaje", "seguimiento", "enviar" ] --- diff --git a/es/api/analytics/assistant-caller-stats.mdx b/es/api/analytics/assistant-caller-stats.mdx index 1348a86e61..9830719c3f 100644 --- a/es/api/analytics/assistant-caller-stats.mdx +++ b/es/api/analytics/assistant-caller-stats.mdx @@ -1,6 +1,5 @@ --- title: "Obtener estadísticas de llamadas del assistant" -description: "Obtén un desglose del número de consultas del assistant por tipo de origen para un rango de fechas determinado." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant/caller-stats keywords: ["analytics", "assistant", "caller", "stats", "export"] --- diff --git a/es/api/analytics/assistant-conversations.mdx b/es/api/analytics/assistant-conversations.mdx index 83bcda2da7..7814b7d72e 100644 --- a/es/api/analytics/assistant-conversations.mdx +++ b/es/api/analytics/assistant-conversations.mdx @@ -1,7 +1,5 @@ --- title: "Obtener conversaciones del assistant" -description: "Obtén el historial de conversaciones del Asistente de IA, - incluidas las consultas, respuestas, fuentes citadas y categorías." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant keywords: [ "analytics", "assistant", "conversations", "export", "AI" ] --- @@ -10,7 +8,7 @@ keywords: [ "analytics", "assistant", "conversations", "export", "AI" ] ## Uso
-Utiliza este endpoint para exportar el historial de conversaciones del Asistente de IA desde tu documentación. Cada conversación incluye la búsqueda del usuario, la respuesta del Asistente de IA, las fuentes citadas y la categoría de la búsqueda. +Utiliza este endpoint para exportar el historial de conversaciones del Asistente de IA desde tu documentación. Cada conversación incluye la búsqueda del usuario, la respuesta del Asistente de IA, las fuentes citadas, el estado de resolución y la categoría de la búsqueda. Pagina los resultados usando el parámetro `cursor` devuelto en la respuesta. Continúa obteniendo resultados mientras `hasMore` sea `true`. @@ -29,4 +27,5 @@ Cada conversación incluye: - **query**: La pregunta del usuario - **response**: La respuesta del assistant - **sources**: Páginas a las que se hace referencia en la respuesta, con título y URL +- **resolutionStatus**: Indica si el assistant respondió correctamente a la pregunta. Puede ser `answered` o `unanswered`. Usa este campo para identificar y analizar lagunas en la documentación detectadas a partir de preguntas de usuarios que el assistant no pudo resolver. - **queryCategory**: Clasificación del tipo de búsqueda (si está disponible) \ No newline at end of file diff --git a/es/api/analytics/feedback-by-page.mdx b/es/api/analytics/feedback-by-page.mdx index 67cb1899c9..e3278942d5 100644 --- a/es/api/analytics/feedback-by-page.mdx +++ b/es/api/analytics/feedback-by-page.mdx @@ -1,6 +1,5 @@ --- title: "Obtener comentarios por página" -description: "Recupera los recuentos de comentarios de los usuarios agregados por página de documentación, incluidas las valoraciones positivas/negativas y los comentarios sobre fragmentos de código." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/feedback/by-page keywords: [ "Analytics", "feedback", "exportación", "por página", "agregado" ] --- diff --git a/es/api/analytics/feedback.mdx b/es/api/analytics/feedback.mdx index 88a165ab4a..37f4dd49c2 100644 --- a/es/api/analytics/feedback.mdx +++ b/es/api/analytics/feedback.mdx @@ -1,8 +1,5 @@ --- title: "Obtener comentarios" -description: "Obtén comentarios de los usuarios sobre tu documentación, - incluidas las valoraciones de las páginas y los comentarios sobre fragmentos - de código." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/feedback keywords: [ "Analytics", "feedback", "exportación", "comentarios de los usuarios" ] --- diff --git a/es/api/analytics/searches.mdx b/es/api/analytics/searches.mdx index bc408b899f..5df22843d7 100644 --- a/es/api/analytics/searches.mdx +++ b/es/api/analytics/searches.mdx @@ -1,6 +1,5 @@ --- title: "Obtener consultas de búsqueda" -description: "Recupera los términos de búsqueda de la documentación con los recuentos de resultados, las tasas de clics y las páginas más visitadas." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/searches keywords: [ "Analytics", "búsqueda", "exportación", "consultas", "términos de búsqueda" ] --- diff --git a/es/api/analytics/views.mdx b/es/api/analytics/views.mdx index da0fd034f4..e6b6409679 100644 --- a/es/api/analytics/views.mdx +++ b/es/api/analytics/views.mdx @@ -1,6 +1,5 @@ --- title: "Obtener vistas de página" -description: "Recupera los recuentos de vistas de contenido por página y de todo el sitio, desglosados por tráfico humano y de IA." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/views keywords: [ "Analytics", "vistas", "vistas de página", "tráfico", "exportación" ] --- diff --git a/es/api/analytics/visitors.mdx b/es/api/analytics/visitors.mdx index c994329842..7207519b36 100644 --- a/es/api/analytics/visitors.mdx +++ b/es/api/analytics/visitors.mdx @@ -1,6 +1,5 @@ --- title: "Obtener visitantes únicos" -description: "Recupera los recuentos aproximados de visitantes únicos por página y de todo el sitio, desglosados por tráfico humano y de IA." openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/visitors keywords: [ "Analytics", "visitantes", "visitantes únicos", "tráfico", "exportación" ] --- diff --git a/es/api/assistant/get-page-content.mdx b/es/api/assistant/get-page-content.mdx index 2778543485..9563fb57e6 100644 --- a/es/api/assistant/get-page-content.mdx +++ b/es/api/assistant/get-page-content.mdx @@ -1,6 +1,5 @@ --- title: "Obtener contenido de la página" -description: "Recupera el contenido de texto completo de una página de documentación por su ruta." openapi: "/es/discovery-openapi.json POST /v1/page/{domain}" keywords: [ "página", "contenido", "recuperar" ] --- diff --git a/es/api/assistant/search.mdx b/es/api/assistant/search.mdx index 3a316350a1..552476d95d 100644 --- a/es/api/assistant/search.mdx +++ b/es/api/assistant/search.mdx @@ -1,7 +1,5 @@ --- title: "Buscar en la documentación" -description: "Busca en tu documentación de forma programática y obtén las - páginas relevantes que coincidan con la búsqueda." openapi: "/es/discovery-openapi.json POST /v1/search/{domain}" keywords: [ "búsqueda", "query" ] --- diff --git a/es/api/preview/trigger.mdx b/es/api/preview/trigger.mdx index b02e2aa7d5..9479a40468 100644 --- a/es/api/preview/trigger.mdx +++ b/es/api/preview/trigger.mdx @@ -1,6 +1,5 @@ --- title: "Activar implementación de vista previa" -description: "Crea o actualiza una implementación de vista previa para una rama específica y revisa los cambios en la documentación antes de fusionarlos a producción." openapi: "/es/openapi.json POST /project/preview/{projectId}" keywords: ["preview", "preview deployment", "branch preview", "staging"] --- diff --git a/es/api/update/status.mdx b/es/api/update/status.mdx index c3f05272c6..36242de796 100644 --- a/es/api/update/status.mdx +++ b/es/api/update/status.mdx @@ -1,7 +1,5 @@ --- title: "Obtener el estado de la implementación" -description: "Consulta el estado de una implementación de la documentación para - supervisar el progreso y la finalización." openapi: "/es/openapi.json GET /project/update-status/{statusId}" keywords: [ "actualizar estado", "estado de implementación", "comprobar estado" ] --- \ No newline at end of file diff --git a/es/api/update/trigger.mdx b/es/api/update/trigger.mdx index 953c2a6dd6..43009756ff 100644 --- a/es/api/update/trigger.mdx +++ b/es/api/update/trigger.mdx @@ -1,8 +1,5 @@ --- title: "Iniciar implementación" -description: "Inicia una implementación de la documentación de forma - programática para publicar actualizaciones fuera de los flujos de trabajo de - Git." openapi: "/es/openapi.json POST /project/update/{projectId}" keywords: [ "disparar", "actualización", "implementación", "programático" ] --- \ No newline at end of file diff --git a/es/create/reusable-snippets.mdx b/es/create/reusable-snippets.mdx index a5adf0fd7d..d65c2c1dcd 100644 --- a/es/create/reusable-snippets.mdx +++ b/es/create/reusable-snippets.mdx @@ -6,6 +6,10 @@ keywords: ["content snippets", "reusable content", "variables"] Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para ese contenido. Los fragmentos incluyen contenido que puedes importar en otros archivos para reutilizarlo. Tú controlas dónde aparece el fragmento en una página. Si alguna vez necesitas actualizar el contenido, solo tendrás que editar el fragmento en lugar de cada archivo donde se use. + + Actualmente, los fragmentos no son compatibles con el editor web. Para usar fragmentos, edita tus archivos MDX localmente con la CLI o envía las importaciones de fragmentos directamente a tu repositorio. + +
## Cómo funcionan los snippets
diff --git a/es/customize/react-components.mdx b/es/customize/react-components.mdx index 131986a35d..548bc564fe 100644 --- a/es/customize/react-components.mdx +++ b/es/customize/react-components.mdx @@ -7,21 +7,14 @@ boost: 3 import { ColorGenerator } from "/snippets/color-generator.jsx"; -Los [componentes de React](https://react.dev) son una forma eficaz de crear elementos interactivos y reutilizables en tu documentación. +Crea elementos interactivos en tus documentos usando [componentes de React](https://react.dev) y [hooks](https://react.dev/reference/react/hooks) directamente en archivos MDX. -
- ## Uso de componentes de React +
+ ## Componentes en línea
-Puedes crear componentes de React directamente en tus archivos MDX mediante [hooks de React](https://react.dev/reference/react/hooks). +Declara componentes directamente en tu archivo MDX: -
- ### Ejemplo -
- -Este ejemplo declara un componente `Counter` y luego lo utiliza con ``. - -```mdx export const Counter = () => { const [count, setCount] = useState(0) @@ -34,7 +27,7 @@ export const Counter = () => { @@ -46,7 +39,7 @@ export const Counter = () => { @@ -56,60 +49,36 @@ export const Counter = () => { } -``` +```mdx export const Counter = () => { const [count, setCount] = useState(0) - const increment = () => setCount(count + 1) const decrement = () => setCount(count - 1) return ( -
-
- - -
- {count} -
- - -
+
+ + {count} +
) } -El contador se representa como un componente interactivo de React. - +``` -
+
## Importar componentes
-Para importar componentes de React en tus archivos MDX, los archivos de los componentes deben estar ubicados en la carpeta `/snippets/`. Más información sobre [snippets reutilizables](/es/create/reusable-snippets). +Los archivos de componentes deben estar en la carpeta `/snippets/`. Más información sobre [fragmentos reutilizables](/es/create/reusable-snippets). -Las importaciones anidadas no se admiten. Si un componente de React hace referencia a otros componentes, debes importar todos los componentes directamente en el archivo MDX principal en lugar de importar componentes dentro de archivos de componentes. + Los imports anidados no son compatibles. Importa todos los componentes referenciados directamente en el archivo MDX padre. -### Ejemplo - -Este ejemplo declara un componente `ColorGenerator` que usa varios hooks de React y luego lo utiliza en un archivo MDX. - -Crea un archivo llamado `color-generator.jsx` en la carpeta `snippets`: +Crea un archivo de componente en `snippets/`: ```mdx /snippets/color-generator.jsx [expandable] export const ColorGenerator = () => { @@ -131,10 +100,10 @@ export const ColorGenerator = () => { navigator.clipboard .writeText(color) .then(() => { - console.log(`${color} copiado al portapapeles`) + console.log(`Copied ${color} to clipboard!`) }) .catch((err) => { - console.error("Error al copiar: ", err) + console.error("Failed to copy: ", err) }) } @@ -143,7 +112,7 @@ export const ColorGenerator = () => {
@@ -224,7 +193,7 @@ export const ColorGenerator = () => { } ``` -Importa el componente `ColorGenerator` y úsalo en un archivo MDX: +Luego impórtalo y úsalo: ```mdx import { ColorGenerator } from "/snippets/color-generator.jsx" @@ -232,27 +201,16 @@ import { ColorGenerator } from "/snippets/color-generator.jsx" ``` -El generador de colores se renderiza como un componente de React interactivo. -
## Consideraciones
- - - Los componentes que usan hooks de React se renderizan en el cliente, lo que tiene varias implicaciones: - - * **SEO**: Es posible que los motores de búsqueda no indexen por completo el contenido dinámico. - * **Carga inicial**: Los visitantes pueden ver un parpadeo de contenido de carga antes de que se rendericen los componentes. - * **Accesibilidad**: Asegúrate de que los cambios en el contenido dinámico se anuncien a los lectores de pantalla. - - - - * **Optimiza los arrays de dependencias**: Incluye solo las dependencias necesarias en tus arrays de dependencias de `useEffect`. - * **Memoriza cálculos complejos**: Usa `useMemo` o `useCallback` para operaciones costosas. - * **Reduce los re-renderizados**: Divide los componentes grandes en otros más pequeños para evitar re-renderizados en cascada. - * **Carga diferida (lazy loading)**: Considera cargar de forma diferida los componentes complejos para mejorar el tiempo de carga inicial de la página. - - \ No newline at end of file +- **SEO**: Es posible que los motores de búsqueda no indexen completamente el contenido dinámico renderizado en el cliente. +- **Carga inicial**: Los visitantes pueden ver un parpadeo antes de que los componentes se rendericen. +- **Accesibilidad**: Asegúrate de que los lectores de pantalla anuncien los cambios de contenido dinámico. +- **Optimiza los arrays de dependencias**: Incluye solo las dependencias necesarias en `useEffect`. +- **Memoriza operaciones costosas**: Usa `useMemo` o `useCallback` cuando proceda. +- **Reduce los renderizados**: Divide los componentes grandes en otros más pequeños. +- **Carga diferida**: Carga de forma diferida los componentes complejos para mejorar el tiempo de carga inicial de la página. diff --git a/es/dashboard/roles.mdx b/es/dashboard/roles.mdx index 93af145086..8bec786c95 100644 --- a/es/dashboard/roles.mdx +++ b/es/dashboard/roles.mdx @@ -14,7 +14,6 @@ Mintlify ofrece tres niveles de acceso al dashboard: lector, editor y administra | | Lector | Editor | Administrador | | ------------------------------------ | :----: | :----: | :-----------: | | Ver contenido en el editor | ✅ | ✅ | ✅ | -| Dejar comentarios y sugerencias | ✅ | ✅ | ✅ | | Ver el dashboard y Analytics | ✅ | ✅ | ✅ | | Hacer preguntas al [Slack agent](/es/agent/slack) | ✅ | ✅ | ✅ | | Editar contenido en el editor web | ❌ | ✅ | ✅ | diff --git a/es/deploy/github.mdx b/es/deploy/github.mdx index 4f88b64aac..b3e688b7d8 100644 --- a/es/deploy/github.mdx +++ b/es/deploy/github.mdx @@ -28,7 +28,8 @@ Si omitiste conectar tu propio repositorio de Git durante la configuración inic La opción de clonación crea automáticamente una copia de tu documentación en tu cuenta de GitHub. - 1. Selecciona **GitHub** como tu proveedor y elige **Clone**. + 1. Selecciona **GitHub** como tu proveedor. + 2. Haz clic en **Clone**. 2. Autoriza con GitHub cuando se te solicite. 3. Selecciona la organización de GitHub donde deseas crear el repositorio. 4. Confirma la clonación. Mintlify copia tus archivos de documentación en un nuevo repositorio. @@ -44,7 +45,8 @@ Si omitiste conectar tu propio repositorio de Git durante la configuración inic Si prefieres configurar tu repositorio manualmente: 1. Descarga tu documentación como un archivo zip para tener una copia de seguridad de tus archivos. - 2. Selecciona **GitHub** como tu proveedor y elige **Continue setup**. + 2. Selecciona **GitHub** como tu proveedor. + 3. Haz clic en **Continue setup**. 3. Autoriza con GitHub cuando se te solicite. 4. Selecciona tu organización, repositorio y rama. 5. Opcionalmente, especifica un subdirectorio si tu documentación no está en la raíz del repositorio. diff --git a/es/editor/collaborate.mdx b/es/editor/collaborate.mdx index 9d5185838b..6eb54c6d59 100644 --- a/es/editor/collaborate.mdx +++ b/es/editor/collaborate.mdx @@ -1,27 +1,63 @@ --- title: "Colaborar en el editor web" sidebarTitle: "Colaborar" -description: "Colabora en la documentación del editor web con branches, pull requests, despliegues de vista previa, enlaces para compartir y edición en tiempo real." -keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments", "share links"] +description: "Edita la documentación con tu equipo mediante colaboración en tiempo real, cursores en vivo, enlaces compartibles del editor, branches y flujos de revisión con pull requests." +keywords: ["editor", "collaboration", "real-time", "live editing", "branches", "pull requests", "preview deployments", "share links"] --- -Colabora con tu equipo en la documentación mediante flujos de trabajo basados en branches, solicitudes de extracción e implementaciones de vista previa. +Colabora con tu equipo en la documentación usando edición en tiempo real y flujos de trabajo basados en branches. -Si no conoces Git, consulta [Conceptos básicos de Git para el editor web](/es/editor/git-essentials). +
+ ## Colaboración en tiempo real +
+ +Varias personas pueden editar la misma página al mismo tiempo. Los cambios de cada persona aparecen para todos los que están en la página. + +Para colaborar en una página en tiempo real, comparte el enlace del editor de esa página con tus compañeros. Consulta [Compartir enlaces del editor](#share-editor-links) más abajo. + + + Editor web mostrando colaboración en tiempo real con varios cursores + Editor web mostrando colaboración en tiempo real con varios cursores + + +
+ ### Cómo funciona la edición en tiempo real +
+ +Cuando varios miembros del equipo editan la misma branch, los cambios se sincronizan en tiempo real. Las actualizaciones de contenido de la página, la estructura de navegación y la configuración del sitio aparecen automáticamente para todos los colaboradores sin necesidad de actualizar. + +- El cursor y las ediciones de cada persona son visibles para todos los que están en la página, con los avatares y nombres de los usuarios mostrados en la barra de herramientas. +- Los cambios se fusionan automáticamente. Que dos personas editen la misma sección no provoca conflictos. +- Deshacer solo afecta a tus propios cambios; deshacer no revierte las ediciones de otra persona. +- Si pierdes la conexión de red, tus ediciones se guardan localmente y se sincronizan cuando vuelves a conectarte. + +
+ ## Ver las ediciones del agente en tiempo real +
+ +Cuando el [agente de Mintlify](/es/agent) edita una página mediante la API o MCP, aparece en el editor web como cualquier otro colaborador. Si tienes la página abierta en la misma branch, verás el avatar y el nombre del agente en la parte superior del editor y un cursor en vivo en la ubicación de su edición más reciente. + +Úsalo para: + +- Ver cómo los cambios del agente se transmiten a la página en tiempo real. +- Saber qué párrafo o bloque acaba de actualizar el agente sin tener que hacer un diff del archivo. +- Coordinarte con tus compañeros y el agente en la misma branch sin sobrescribir el trabajo de los demás. + +El cursor del agente se borra automáticamente poco después de que el agente termina de editar.
## Colaboración basada en branches
-Utiliza branches para trabajar en paralelo en actualizaciones de la documentación sin afectar tu sitio en producción. +Utiliza branches para trabajar en paralelo en actualizaciones de la documentación sin afectar tu sitio en producción. Si no conoces Git, consulta [Conceptos básicos de Git para el editor web](/es/editor/git-essentials).
### Por qué usar branches
-* **Aislar cambios**: Trabaja en actualizaciones sin afectar tu documentación en producción. -* **Revisar antes de publicar**: Obtén comentarios del equipo antes de publicar los cambios. -* **Trabajo en paralelo**: Varios miembros del equipo pueden trabajar en diferentes branches al mismo tiempo. +- **Aislar cambios**: Trabaja en actualizaciones sin afectar tu documentación en producción. +- **Revisar antes de publicar**: Obtén comentarios del equipo antes de publicar los cambios. +- **Trabajo en paralelo**: Varios miembros del equipo pueden trabajar en diferentes branches al mismo tiempo.