diff --git a/docs.json b/docs.json index 266a91bb2..2f8762811 100644 --- a/docs.json +++ b/docs.json @@ -286,7 +286,7 @@ "tab": "Documentation", "groups": [ { - "group": "Pour commencer", + "group": "Prise en main", "pages": [ "fr/index", "fr/quickstart", @@ -471,7 +471,7 @@ ] }, { - "group": "SDKs", + "group": "SDK", "icon": "folder-code", "pages": [ "fr/integrations/sdks/speakeasy", @@ -498,7 +498,7 @@ ] }, { - "group": "Contrôle de version et CI/CD", + "group": "Gestion de versions et CI/CD", "pages": [ "fr/settings/github", "fr/settings/gitlab", @@ -574,7 +574,7 @@ ] }, { - "group": "Configuración principal", + "group": "Configuración básica", "pages": [ "es/settings", "es/pages", @@ -672,7 +672,7 @@ "pages": [ "es/guides/migration", { - "group": "Dashboard de Analytics", + "group": "Analytics dashboard", "icon": "chart-line", "pages": [ "es/analytics/overview", @@ -820,7 +820,7 @@ "tab": "文档", "groups": [ { - "group": "快速入门", + "group": "快速开始", "pages": [ "zh/index", "zh/quickstart", diff --git a/es/advanced/dashboard/permissions.mdx b/es/advanced/dashboard/permissions.mdx index 39971cb1d..48f5721b4 100644 --- a/es/advanced/dashboard/permissions.mdx +++ b/es/advanced/dashboard/permissions.mdx @@ -7,8 +7,8 @@ Un editor tiene acceso a tu dashboard y al editor web. Cualquiera puede contribuir a tu documentación trabajando localmente y enviando cambios a tu repositorio, pero hay diferencias clave en cómo se publican los cambios: -* **Cambios de editor**: Cuando un editor publica a través del editor web o fusiona una solicitud de extracción en tu repositorio de documentación, los cambios se implementan automáticamente en tu sitio en producción. -* **Cambios de no editor**: Cuando alguien que no es editor fusiona una solicitud de extracción en tu repositorio, debes activar manualmente una implementación desde tu dashboard para que esos cambios aparezcan en tu sitio en producción. +* **Cambios de editor**: Cuando un editor publica a través del editor web o fusiona una solicitud de extracción en el repositorio de tu documentación, los cambios se implementan automáticamente en tu sitio en vivo. +* **Cambios de no editor**: Cuando alguien que no es editor fusiona una solicitud de extracción en tu repositorio, debes activar manualmente una implementación desde tu dashboard para que esos cambios aparezcan en tu sitio en vivo. @@ -18,4 +18,4 @@ Cualquiera puede contribuir a tu documentación trabajando localmente y enviando De forma predeterminada, el miembro del equipo que creó tu organización en Mintlify tiene acceso de editor. Agrega editores adicionales en la página [Members](https://dashboard.mintlify.com/settings/organization/members) de tu dashboard. -Las plazas de editor se facturan según el uso y puedes tener tantos editores como necesites. Consulta nuestra [página de precios](https://mintlify.com/pricing) para más detalles. +Los asientos de editor se facturan según el uso y puedes tener tantos editores como necesites. Consulta nuestra [página de precios](https://mintlify.com/pricing) para más detalles. diff --git a/es/advanced/dashboard/roles.mdx b/es/advanced/dashboard/roles.mdx index 5cb385879..0f04f94f9 100644 --- a/es/advanced/dashboard/roles.mdx +++ b/es/advanced/dashboard/roles.mdx @@ -7,20 +7,20 @@ description: "Controla el acceso a tu dashboard con roles." La funcionalidad RBAC está disponible en el [plan Enterprise](https://mintlify.com/pricing?ref=rbac). -Mintlify ofrece dos niveles de acceso al dashboard: Editor y Admin. +Mintlify ofrece dos niveles de acceso al dashboard: Editor y Administrador. -A continuación se describen las acciones restringidas al rol de Admin: +A continuación se describen las acciones que están restringidas al rol de Administrador: -| | Editor | Admin | -| ----------------------- | :----: | :---: | -| Actualizar roles de usuario | ❌ | ✅ | -| Eliminar usuarios | ❌ | ✅ | -| Invitar usuarios admin | ❌ | ✅ | -| Gestionar y actualizar la facturación | ❌ | ✅ | -| Actualizar domain personalizado | ❌ | ✅ | -| Actualizar Git source | ❌ | ✅ | -| Eliminar org | ❌ | ✅ | +| | Editor | Administrador | +| ----------------------- | :----: | :-----------: | +| Actualizar roles de usuario | ❌ | ✅ | +| Eliminar usuarios | ❌ | ✅ | +| Invitar usuarios administradores | ❌ | ✅ | +| Gestionar y actualizar la facturación | ❌ | ✅ | +| Actualizar el dominio personalizado | ❌ | ✅ | +| Actualizar la source de Git | ❌ | ✅ | +| Eliminar la organización | ❌ | ✅ | -Otras acciones en el dashboard están disponibles para ambos roles. +Las demás acciones del dashboard están disponibles para ambos roles. -Puedes invitar a tantos admins como quieras, pero recomendamos limitar el acceso de admin a quienes lo necesiten. +Puedes invitar a tantos administradores como quieras, pero recomendamos limitar el acceso de administrador a quienes lo necesiten. diff --git a/es/advanced/dashboard/sso.mdx b/es/advanced/dashboard/sso.mdx index d4409a880..cc3d31796 100644 --- a/es/advanced/dashboard/sso.mdx +++ b/es/advanced/dashboard/sso.mdx @@ -1,13 +1,13 @@ --- title: "Inicio de sesión único (SSO)" -description: "Personaliza cómo tu equipo puede iniciar sesión en tu dashboard de administración" +description: "Personaliza cómo tu equipo puede acceder a tu dashboard de administración" --- La funcionalidad de SSO está disponible en el [plan Enterprise](https://mintlify.com/pricing?ref=sso). -Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Okta, Google Workspace o Microsoft Entra, contamos con documentación específica del proveedor para configurar SSO. Si usas otro proveedor, [ponte en contacto con nosotros](mailto:support@mintlify.com). +Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Okta, Google Workspace o Microsoft Entra, contamos con documentación específica por proveedor para configurar SSO. Si usas otro proveedor, [contáctanos](mailto:support@mintlify.com).
## Okta @@ -16,10 +16,10 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok - - En `Applications`, haz clic para crear una nueva integración de aplicación usando SAML 2.0. + + En `Applications`, haz clic para crear una nueva integración de aplicación con SAML 2.0. - + Ingresa lo siguiente: * Single sign-on URL (proporcionada por Mintlify) * Audience URI (proporcionada por Mintlify) @@ -30,24 +30,24 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok | `firstName` | Basic | `user.firstName` | | `lastName` | Basic | `user.lastName` | - - Una vez que la aplicación esté configurada, navega a la pestaña de inicio de sesión y envíanos la metadata URL. - Habilitaremos la conexión desde nuestro lado usando esta información. + + Una vez configurada la aplicación, ve a la pestaña de inicio de sesión y envíanos la metadata URL. + Habilitaremos la conexión por nuestra parte con esta información. - - En `Applications`, haz clic para crear una nueva integración de aplicación usando OIDC. + + En `Applications`, haz clic para crear una nueva integración de aplicación con OIDC. Debes elegir el tipo de aplicación `Web Application`. - - Selecciona el grant type authorization code y proporciona la Redirect URI indicada por Mintlify. + + Selecciona el tipo de concesión Authorization Code y proporciona la Redirect URI que te dio Mintlify. - - Una vez que la aplicación esté configurada, navega a la pestaña General y localiza el Client ID y el client secret. - Proporciónanos estos de forma segura, junto con la URL de tu instancia de Okta (por ejemplo, `.okta.com`). Puedes enviarlos mediante un servicio como 1Password o SendSafely. + + Una vez configurada la aplicación, ve a la pestaña General y localiza el Client ID y el client secret. + Por favor, facilítanos estos datos de forma segura, junto con la URL de tu instancia de Okta (por ejemplo, `.okta.com`). Puedes enviarlos mediante un servicio como 1Password o SendSafely. @@ -74,7 +74,7 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok En la página Service provider details, introduce lo siguiente: - * ACS URL (proporcionada por Mintlify) + * ACS URL (proporcionado por Mintlify) * Entity ID (proporcionado por Mintlify) * Name ID format: `EMAIL` * Name ID: `Basic Information > Primary email` @@ -83,13 +83,13 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok ![](/images/gsuite-sp-details.png) - En la siguiente página, introduce las siguientes declaraciones de atributos: + En la página siguiente, introduce las siguientes declaraciones de atributos: | Google Directory Attribute | App Attribute | | -------------------------- | ------------- | | `First name` | `firstName` | | `Last name` | `lastName` | - Cuando completes este paso y hayas asignado usuarios a la aplicación, avísanos y habilitaremos el SSO para tu cuenta. + Cuando completes este paso y los usuarios estén asignados a la aplicación, avísanos y habilitaremos el SSO para tu cuenta. @@ -104,7 +104,7 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok 1. En "Enterprise applications", selecciona **New application**. - 2. Selecciona **Create your own application** y elige "Integrate any other application you don't find in the gallery (Non-gallery)". + 2. Selecciona **Create your own application** y elige "Integrate any other application you don't find in the gallery (Non-gallery)." Ve a la página de configuración de Single Sign-On y selecciona **SAML**. En "Basic SAML Configuration", ingresa lo siguiente: @@ -113,22 +113,22 @@ Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si usas Ok Deja los demás valores en blanco y selecciona **Save**. - + Edita la sección Attributes & Claims: 1. Selecciona **Unique User Identifier (Name ID)** en "Required Claim". 2. Cambia el atributo Source para usar `user.primaryauthoritativeemail`. - 3. En Additional claims, crea los siguientes claims: + 3. En Additional claims, crea las siguientes claims: | Name | Value | | ---- | ----- | | `firstName` | `user.givenname` | | `lastName` | `user.surname` | - + Una vez que la aplicación esté configurada, ve a la sección "SAML Certificates" y envíanos el App Federation Metadata URL. Habilitaremos la conexión por nuestra parte con esta información. - Ve a "Users and groups" en tu aplicación de Entra y agrega a los usuarios que deban tener acceso a tu dashboard. + Ve a "Users and groups" en tu aplicación de Entra y añade a los usuarios que deben tener acceso a tu dashboard. diff --git a/es/advanced/subpath/cloudflare.mdx b/es/advanced/subpath/cloudflare.mdx index 4ff8d4fb8..5cf1837e4 100644 --- a/es/advanced/subpath/cloudflare.mdx +++ b/es/advanced/subpath/cloudflare.mdx @@ -1,14 +1,14 @@ --- title: "Cloudflare" -description: "Aloja documentación en una subruta personalizada con Cloudflare Workers" +description: "Aloja la documentación en una subruta personalizada con Cloudflare Workers" --- import Propagating from "/snippets/es/custom-subpath-propagating.mdx"; -Para alojar tu documentación en una subruta personalizada como `yoursite.com/docs` usando Cloudflare, necesitarás crear y configurar un Cloudflare Worker. +Para alojar tu documentación en una subruta personalizada como `yoursite.com/docs` con Cloudflare, necesitas crear y configurar un Cloudflare Worker. - Antes de comenzar, necesitas una cuenta de Cloudflare y un nombre de dominio (puede gestionarse dentro o fuera de Cloudflare). + Antes de empezar, necesitas una cuenta de Cloudflare y un nombre de dominio (puede gestionarse dentro o fuera de Cloudflare). @@ -22,7 +22,7 @@ Tus archivos de documentación deben organizarse dentro de tu repositorio para q ## Configura un Cloudflare Worker
-Crea un Cloudflare Worker siguiendo la [guía de introducción a Cloudflare Workers](https://developers.cloudflare.com/workers/get-started/dashboard/) si aún no lo has hecho. +Crea un Cloudflare Worker siguiendo la [guía de inicio de Cloudflare Workers](https://developers.cloudflare.com/workers/get-started/dashboard/), si aún no lo has hecho. Si tu proveedor de DNS es Cloudflare, no habilites el proxy para el registro CNAME. @@ -32,20 +32,20 @@ Crea un Cloudflare Worker siguiendo la [guía de introducción a Cloudflare Work ### Proxies con implementaciones de Vercel -Si usas Cloudflare como proxy con implementaciones de Vercel, debes asegurarte de una configuración adecuada para evitar conflictos con la verificación de domain de Vercel y el aprovisionamiento de certificados SSL. +Si usas Cloudflare como proxy con implementaciones de Vercel, debes asegurarte de una configuración adecuada para evitar conflictos con la verificación del domain de Vercel y el aprovisionamiento de certificados SSL. -Una configuración de proxy incorrecta puede impedir que Vercel aprovisione certificados SSL de Let's Encrypt y provocar errores en la verificación del domain. +Una configuración de proxy incorrecta puede impedir que Vercel aprovisione certificados SSL de Let's Encrypt y causar fallas en la verificación del domain.
#### Lista obligatoria de rutas permitidas
-Tu Cloudflare Worker debe permitir el tráfico a estas rutas específicas sin bloquear ni redirigir: +Tu Cloudflare Worker debe permitir el tráfico hacia estas rutas específicas sin bloquear ni redirigir: - `/.well-known/acme-challenge/*` - Obligatorio para la verificación de certificados de Let's Encrypt -- `/.well-known/vercel/*` - Obligatorio para la verificación del domain de Vercel +- `/.well-known/vercel/*` - Obligatorio para la verificación del domain en Vercel -Si bien Cloudflare maneja automáticamente muchas reglas de verificación, crear reglas personalizadas adicionales puede bloquear inadvertidamente este tráfico crítico. +Aunque Cloudflare maneja automáticamente muchas reglas de verificación, crear reglas personalizadas adicionales puede bloquear inadvertidamente este tráfico crítico.
#### Requisitos para el reenvío de encabezados @@ -115,7 +115,7 @@ Selecciona **Deploy** y espera a que los cambios se propaguen. Después de desplegar tu código, prueba tu Worker para asegurarte de que dirige a tu documentación de Mintlify. 1. Prueba usando la URL de vista previa del Worker: `your-worker.your-subdomain.workers.dev/docs` -2. Verifica que el Worker dirija a tu documentación de Mintlify y a tu sitio web. +2. Verifica que el Worker dirige a tu documentación de Mintlify y a tu sitio web.
### Agregar domain personalizado @@ -126,7 +126,7 @@ Después de desplegar tu código, prueba tu Worker para asegurarte de que dirige 3. Agrega tu domain. - Te recomendamos agregar tu domain tanto con `www.` como sin `www.`. + Recomendamos agregar tu domain tanto con `www.` como sin `www.` al inicio. Consulta [Add a custom domain](https://developers.cloudflare.com/workers/configuration/routing/custom-domains/#add-a-custom-domain) en la documentación de Cloudflare para obtener más información. @@ -135,27 +135,27 @@ Consulta [Add a custom domain](https://developers.cloudflare.com/workers/configu ### Resolver conflictos de DNS
-Si tu domain ya apunta a otro servicio, debes eliminar el registro DNS existente. Tu Cloudflare Worker debe estar configurado para controlar todo el tráfico de tu domain. +Si tu domain ya apunta a otro servicio, debes eliminar el registro de DNS existente. Tu Cloudflare Worker debe estar configurado para controlar todo el tráfico de tu domain. -1. Elimina el registro DNS existente para tu domain. Consulta [Delete DNS records](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/#delete-dns-records) en la documentación de Cloudflare para obtener más información. +1. Elimina el registro de DNS existente para tu domain. Consulta [Eliminar registros de DNS](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/#delete-dns-records) en la documentación de Cloudflare para obtener más información. 2. Vuelve a tu Worker y añade tu domain personalizado.
## Enrutamiento personalizado en Webflow
-Si usas Webflow para alojar tu sitio principal y quieres servir la documentación de Mintlify en `/docs` en el mismo domain, deberás configurar un enrutamiento personalizado mediante Cloudflare Workers para enrutar todo el tráfico que no sea de docs a tu sitio principal. +Si usas Webflow para alojar tu sitio principal y quieres servir la documentación de Mintlify en `/docs` en el mismo domain, necesitarás configurar enrutamiento personalizado con Cloudflare Workers para redirigir mediante proxy todo el tráfico que no sea de docs hacia tu sitio principal. Asegúrate de que tu sitio principal esté configurado en una página de aterrizaje antes de implementar este Worker, o los visitantes de tu sitio principal verán errores. -1. En Webflow, configura una página de aterrizaje para tu sitio principal, por ejemplo `landing.yoursite.com`. Esta será la página que verán los visitantes cuando ingresen a tu sitio. +1. En Webflow, configura una página de aterrizaje para tu sitio principal, por ejemplo `landing.yoursite.com`. Esta será la página que verán los visitantes cuando entren a tu sitio. 2. Implementa tu sitio principal en la página de aterrizaje. Esto garantiza que tu sitio principal siga siendo accesible mientras configuras el Worker. -3. Para evitar conflictos, actualiza cualquier URL absoluta en tu sitio principal para que sean relativas. +3. Para evitar conflictos, actualiza cualquier URL absoluta en tu sitio principal para que sea relativa. 4. En Cloudflare, selecciona **Edit Code** y agrega el siguiente script en el código de tu Worker. - Reemplaza `[SUBDOMAIN]` con tu subdomain único, `[YOUR_DOMAIN]` con la URL base de tu sitio web, `[LANDING_DOMAIN]` con la URL de tu página de aterrizaje y `/docs` con la subruta deseada si es diferente. + Reemplaza `[SUBDOMAIN]` por tu subdomain única, `[YOUR_DOMAIN]` por la URL base de tu sitio web, `[LANDING_DOMAIN]` por la URL de tu página de aterrizaje y `/docs` por la subruta que desees si es distinta. ```javascript addEventListener("fetch", (event) => { diff --git a/es/advanced/subpath/route53-cloudfront.mdx b/es/advanced/subpath/route53-cloudfront.mdx index b191ac10c..d338f3998 100644 --- a/es/advanced/subpath/route53-cloudfront.mdx +++ b/es/advanced/subpath/route53-cloudfront.mdx @@ -1,7 +1,7 @@ --- title: "AWS Route 53 y CloudFront" sidebarTitle: "AWS" -description: "Aloja la documentación en una subruta personalizada con servicios de AWS" +description: "Aloja la documentación en una subruta personalizada usando servicios de AWS" --- import Propagating from "/snippets/es/custom-subpath-propagating.mdx"; @@ -13,27 +13,27 @@ Para alojar tu documentación en una subruta personalizada como `yoursite.com/do ## Estructura del repositorio
-Tus archivos de documentación deben organizarse dentro de tu repositorio para que coincidan con la estructura de subruta que elijas. Por ejemplo, si quieres que tu documentación esté en `yoursite.com/docs`, crea un directorio `docs/` con todos tus archivos de documentación. +Los archivos de documentación deben organizarse dentro de tu repositorio para que coincidan con la estructura de subruta que elijas. Por ejemplo, si quieres que tu documentación esté en `yoursite.com/docs`, crea un directorio `docs/` con todos tus archivos de documentación.
- ## Descripción general de alto nivel + ## Descripción general
-Dirige el tráfico a estas rutas con una política de caché **CachingDisabled**: +Redirige el tráfico a estas rutas con una política de caché **CachingDisabled**: - `/.well-known/acme-challenge/*` - Obligatorio para la verificación de certificados de Let's Encrypt -- `/.well-known/vercel/*` - Obligatorio para la verificación de domain -- `/docs/*` - Obligatorio para el enrutamiento de subruta -- `/docs/` - Obligatorio para el enrutamiento de subruta +- `/.well-known/vercel/*` - Obligatorio para la verificación del domain +- `/docs/*` - Obligatorio para el enrutamiento por subruta +- `/docs/` - Obligatorio para el enrutamiento por subruta -Dirige el tráfico a esta ruta con una política de caché **CachingEnabled**: +Redirige el tráfico a esta ruta con una política de caché **CachingEnabled**: - `/mintlify-assets/_next/static/*` - `Default (*)` - La página de inicio de tu sitio web -Todos los Behaviors deben tener una **origin request policy** de `AllViewerExceptHostHeader`. +Todos los comportamientos deben tener una **política de solicitud de origen** de `AllViewerExceptHostHeader`. -![Página de CloudFront "Behaviors" con 4 behaviors: `/docs/*`, `/docs`, `Default`, y `/.well-known/*`.](/images/cloudfront/all-behaviors.png) +![Página de CloudFront "Behaviors" con 4 comportamientos: `/docs/*`, `/docs`, `Default` y `/.well-known/*`.](/images/cloudfront/all-behaviors.png)
## Crear una distribución de CloudFront @@ -49,7 +49,7 @@ Todos los Behaviors deben tener una **origin request policy** de `AllViewerExcep 3. En Origin domain, introduce `[SUBDOMAIN].mintlify.dev`, donde `[SUBDOMAIN]` es el subdomain único de tu proyecto. - ![Página "Create distribution" de CloudFront mostrando "acme.mintlify.dev" como Origin domain.](/images/cloudfront/origin-name.png) + ![Página de CloudFront "Create distribution" mostrando "acme.mintlify.dev" como el origin domain.](/images/cloudfront/origin-name.png) 4. En "Web Application Firewall (WAF)", habilita las protecciones de seguridad. @@ -65,16 +65,16 @@ Todos los Behaviors deben tener una **origin request policy** de `AllViewerExcep ## Agregar origen predeterminado
-1. Después de crear la distribución, ve a la Tab "Origins". +1. Después de crear la distribución, ve a la pestaña "Origins". - ![Una distribución de CloudFront con la Tab "Origins" resaltada.](/images/cloudfront/origins.png) + ![Una distribución de CloudFront con la pestaña "Origins" resaltada.](/images/cloudfront/origins.png) -2. Busca tu URL de staging que refleje el dominio principal. Esto varía mucho según cómo esté alojada tu página de destino. Por ejemplo, la URL de staging de Mintlify es [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app). +2. Busca tu URL de staging que refleje el dominio principal. Esto varía mucho según dónde esté alojada tu landing page. Por ejemplo, la URL de staging de Mintlify es [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app). - Si tu página de destino está alojada en Webflow, usa la URL de staging de Webflow. Tendrá el formato `.webflow.io`. + Si tu landing page está alojada en Webflow, usa la URL de staging de Webflow. Se verá como `.webflow.io`. Si usas Vercel, usa el domain `.vercel.app` disponible para cada proyecto. @@ -82,13 +82,13 @@ Todos los Behaviors deben tener una **origin request policy** de `AllViewerExcep 3. Crea un nuevo Origin y agrega tu URL de staging como el "Origin domain". - ![Página "Create origin" de CloudFront con un campo de entrada "Origin domain" resaltado.](/images/cloudfront/default-origin.png) + ![Página de CloudFront "Create origin" con un campo de entrada "Origin domain" resaltado.](/images/cloudfront/default-origin.png) A estas alturas, deberías tener dos Origins: uno con `[SUBDOMAIN].mintlify.app` y otro con tu URL de staging. - ![Página "Origins" de CloudFront con dos orígenes: uno para `mintlify` y otro para `mintlify-landing-page`.](/images/cloudfront/final-origins.png) + ![Página de CloudFront "Origins" con dos orígenes: uno para `mintlify` y otro para `mintlify-landing-page`.](/images/cloudfront/final-origins.png)
@@ -97,8 +97,8 @@ A estas alturas, deberías tener dos Origins: uno con `[SUBDOMAIN].mintlify.app` Los comportamientos en CloudFront permiten controlar la lógica de subrutas. A grandes rasgos, queremos implementar la siguiente lógica: -- **Si un usuario llega a tu subruta personalizada**, redirigir a `[SUBDOMAIN].mintlify.dev`. -- **Si un usuario llega a cualquier otra página**, ir a la página de inicio actual. +- **Si un usuario llega a tu subruta personalizada**, dirigir a `[SUBDOMAIN].mintlify.dev`. +- **Si un usuario llega a cualquier otra página**, dirigir a la página de inicio actual. 1. Ve a la pestaña "Behaviors" de tu distribución de CloudFront. @@ -112,16 +112,16 @@ Los comportamientos en CloudFront permiten controlar la lógica de subrutas. A g ### `/.well-known/*`
-Crea comportamientos para las rutas de verificación de dominios de Vercel con un **Patrón de ruta** de `/.well-known/*` y configura **Origin and origin groups** a la URL de tu documentación. +Crea comportamientos para las rutas de verificación de dominio de Vercel con un **Patrón de ruta** de `/.well-known/*` y configura **Origin and origin groups** a la URL de tu documentación. -Para "Cache policy", selecciona **CachingDisabled** para asegurarte de que estas solicitudes de verificación se procesen sin caché. +Para "Cache policy", selecciona **CachingDisabled** para asegurarte de que estas solicitudes de verificación se transmitan sin caché. ![Página de CloudFront "Create behavior" con un "Path pattern" de "/.well-known/*" y "Origin and origin groups" apuntando a la URL de staging.](/images/cloudfront/well-known-policy.png) -Si `.well-known/*` es demasiado genérico, puede acotarse a un mínimo de 2 comportamientos para Vercel: +Si `.well-known/*` es demasiado genérico, puedes acotarlo a un mínimo de 2 comportamientos para Vercel: - `/.well-known/vercel/*` - Obligatorio para la verificación de dominio de Vercel - `/.well-known/acme-challenge/*` - Obligatorio para la verificación de certificados de Let's Encrypt @@ -130,11 +130,11 @@ Si `.well-known/*` es demasiado genérico, puede acotarse a un mínimo de 2 comp ### Tu subruta personalizada -Crea un comportamiento con un **Patrón de ruta** de la subruta que elijas, por ejemplo `/docs`, con **Origen y grupos de origen** apuntando a la URL `.mintlify.dev` (en nuestro caso `acme.mintlify.dev`). +Crea un comportamiento con un **Patrón de ruta** para la subruta que elijas, por ejemplo `/docs`, con **Origin and origin groups** apuntando a la URL `.mintlify.dev` (en nuestro caso `acme.mintlify.dev`). -- Establece "Cache policy" en **CachingOptimized**. -- Establece "Origin request policy" en **AllViewerExceptHostHeader**. -- Establece "Viewer Protocol Policy" en **Redirect HTTP to HTTPS**. +- Configura "Cache policy" en **CachingOptimized**. +- Configura "Origin request policy" en **AllViewerExceptHostHeader**. +- Configura "Viewer Protocol Policy" en **Redirect HTTP to HTTPS**. ![Página de CloudFront "Create behavior" con un "Path pattern" de "/docs/*" y "Origin and origin groups" apuntando a la URL `acme.mintlify.dev`.](/images/cloudfront/behavior-1.png) @@ -144,9 +144,9 @@ Crea un comportamiento con un **Patrón de ruta** de la subruta que elijas, por ### Tu subruta personalizada con comodín -Crea un comportamiento con un **Patrón de ruta** de la subruta que elijas seguido de `/*`, por ejemplo `/docs/*`, y con **Origen y grupos de origen** apuntando a la misma URL `.mintlify.dev`. +Crea un comportamiento con un **Patrón de ruta** de la subruta que elijas seguida de `/*`, por ejemplo `/docs/*`, y **Origen y grupos de orígenes** apuntando a la misma URL `.mintlify.dev`. -Estos ajustes deben coincidir exactamente con el comportamiento de tu subruta base, con la única excepción del **Patrón de ruta**. +Estos ajustes deben coincidir exactamente con el comportamiento de tu subruta base, con la excepción del **Patrón de ruta**. - Establece "Cache policy" en **CachingOptimized**. - Establece "Origin request policy" en **AllViewerExceptHostHeader**. @@ -156,9 +156,9 @@ Estos ajustes deben coincidir exactamente con el comportamiento de tu subruta ba ### `/mintlify-assets/_next/static/*` -- Establece la "política de caché" en **CachingOptimized** - - Establece la "política de solicitud al origen" en **AllViewerExceptHostHeader** - - Establece la "política de protocolo del visor" en **Redirect HTTP to HTTPS** +- Configura "Cache policy" en **CachingOptimized** + - Configura "Origin request policy" en **AllViewerExceptHostHeader** + - Configura "Viewer protocol policy" en **Redirect HTTP to HTTPS**
### `Default (*)` @@ -167,44 +167,44 @@ Estos ajustes deben coincidir exactamente con el comportamiento de tu subruta ba Por último, vamos a editar el comportamiento `Default (*)`. - ![Una distribución de CloudFront con el comportamiento "Default (*)" seleccionado y el botón Edit destacado.](/images/cloudfront/default-behavior-1.png) + ![Una distribución de CloudFront con el comportamiento "Default (*)" seleccionado y el botón Edit enfatizado.](/images/cloudfront/default-behavior-1.png) 1. Cambia **Origin and origin groups** del comportamiento predeterminado a la URL de staging (en nuestro caso, `mintlify-landing-page.vercel.app`). - ![Página de CloudFront "Edit behavior" con el campo "Origin and origin groups" resaltado.](/images/cloudfront/default-behavior-2.png) + ![Página de CloudFront "Edit behavior" con el campo de entrada "Origin and origin groups" resaltado.](/images/cloudfront/default-behavior-2.png) 2. Selecciona **Guardar cambios**.
- ### Verifica que los comportamientos estén configurados correctamente + ### Comprueba que los comportamientos estén configurados correctamente
-Si sigues los pasos anteriores, tus comportamientos deberían verse así: +Si seguiste los pasos anteriores, tus comportamientos deberían verse así: - ![Página de CloudFront "Behaviors" con 4 comportamientos: `/docs/*`, `/docs`, `Default` y `/.well-known/*`.](/images/cloudfront/all-behaviors.png) + ![Página de CloudFront “Behaviors” con 4 comportamientos: `/docs/*`, `/docs`, `Default` y `/.well-known/*`.](/images/cloudfront/all-behaviors.png)
## Vista previa de la distribución
-Ahora puedes comprobar si tu distribución está correctamente configurada yendo a la pestaña «General» y visitando la URL de **Distribution domain name**. +Ahora puedes comprobar si tu distribución está configurada correctamente yendo a la pestaña "General" y visitando la URL de **Distribution domain name**. - ![Pestaña «General» de CloudFront con la URL «Distribution domain name» resaltada.](/images/cloudfront/preview-distribution.png) + ![Pestaña "General" de CloudFront con la URL de "Distribution domain name" resaltada.](/images/cloudfront/preview-distribution.png) -Todas las páginas deberían redirigir a tu página principal, pero si agregas la subruta que elegiste —por ejemplo, `/docs`— a la URL, deberías ver que te lleva a tu instancia de documentación de Mintlify. +Todas las páginas deberían redirigir a tu página de inicio principal, pero si agregas la subruta que elegiste, por ejemplo `/docs`, a la URL, deberías ver que te lleva a tu instancia de documentación de Mintlify.
## Conectar con Route53
-Ahora llevaremos la funcionalidad de la distribución de CloudFront a tu dominio principal. +Ahora llevaremos la funcionalidad de la distribución de CloudFront a tu domain principal. Para esta sección, también puedes consultar la guía oficial de AWS sobre [Configurar @@ -213,7 +213,7 @@ Ahora llevaremos la funcionalidad de la distribución de CloudFront a tu dominio 1. Ve a [Route53](https://aws.amazon.com/route53) en la consola de AWS. -2. Ve a la “Hosted zone” de tu dominio principal. +2. Ve a la "Hosted zone" de tu domain principal. 3. Selecciona **Create record**. @@ -223,7 +223,7 @@ Ahora llevaremos la funcionalidad de la distribución de CloudFront a tu dominio 4. Activa `Alias` y luego, en **Route traffic to**, elige la opción `Alias to CloudFront distribution`. - ![Página "Create record" de Route 53 con el interruptor "Alias" y el menú "Route traffic to" destacados.](/images/cloudfront/create-record-alias.png) + ![Página "Create record" de Route 53 con el interruptor "Alias" y el menú "Route traffic to" resaltados.](/images/cloudfront/create-record-alias.png) 5. Selecciona **Create records**. @@ -232,6 +232,6 @@ Ahora llevaremos la funcionalidad de la distribución de CloudFront a tu dominio Es posible que debas eliminar el registro A existente si ya hay uno. -Tu documentación ahora está disponible en la subruta elegida de tu dominio principal. +Tu documentación ahora está disponible en la subruta que elegiste para tu domain principal. \ No newline at end of file diff --git a/es/advanced/subpath/vercel.mdx b/es/advanced/subpath/vercel.mdx index 8764f72d4..d2301dcb7 100644 --- a/es/advanced/subpath/vercel.mdx +++ b/es/advanced/subpath/vercel.mdx @@ -10,19 +10,19 @@ import { VercelJsonGenerator } from "/snippets/es/vercel-json-generator.mdx"; ## archivo vercel.json
-El archivo `vercel.json` configura cómo se crea y se implementa tu proyecto. Se encuentra en el directorio raíz de tu proyecto y controla varios aspectos de la implementación, incluidos el enrutamiento, las redirecciones, los encabezados y la configuración de compilación. +El archivo `vercel.json` define cómo se compila y se implementa tu proyecto. Se ubica en el directorio raíz y controla varios aspectos de la implementación, como el enrutamiento, las redirecciones, los encabezados y la configuración de compilación. -Usamos la configuración `rewrites` para enrutar mediante proxy las solicitudes desde tu dominio principal hacia tu documentación. +Usamos la configuración `rewrites` para hacer de proxy las solicitudes desde tu dominio principal hacia tu documentación. -Los `rewrites` mapean las solicitudes entrantes a destinos diferentes sin cambiar la URL en el navegador. Cuando alguien visita `yoursite.com/docs`, Vercel obtendrá internamente contenido de `your-subdomain.mintlify.dev/docs`, pero el usuario seguirá viendo `yoursite.com/docs` en su navegador. Esto es diferente de las redirecciones, que enviarían a los usuarios a una URL completamente distinta. +Las reescrituras mapean las solicitudes entrantes a distintos destinos sin cambiar la URL en el navegador. Cuando alguien visita `yoursite.com/docs`, Vercel obtendrá internamente el contenido desde `your-subdomain.mintlify.dev/docs`, pero la persona seguirá viendo `yoursite.com/docs` en su navegador. Esto difiere de las redirecciones, que enviarían a los usuarios a una URL completamente distinta. -Puedes personalizar la subruta con cualquier valor que prefieras, como `/docs`, `/help` o `/guides`. Además, puedes usar subrutas de varios niveles, como `/product/docs`. +Puedes personalizar la subruta con cualquier valor que prefieras, como `/docs`, `/help` o `/guides`. Además, puedes usar subrutas profundamente anidadas como `/product/docs`.
## Estructura del repositorio
-Los archivos de documentación deben organizarse dentro de tu repositorio para que coincidan con la estructura de subruta que elijas. Por ejemplo, si quieres que tu documentación esté en `yoursite.com/docs`, deberías crear un directorio `docs/` con todos tus archivos de documentación. +Tus archivos de documentación deben estar organizados dentro de tu repositorio para que coincidan con la estructura de la subruta que elijas. Por ejemplo, si quieres tu documentación en `yoursite.com/docs`, deberías crear un directorio `docs/` con todos tus archivos de documentación.
## Configuración @@ -45,8 +45,8 @@ Para alojar tu documentación en una subruta personalizada con Vercel, agrega la } ``` -* **`source`**: El patrón de ruta en tu domain que desencadena la reescritura. -* **`destination`**: El destino al que se debe reenviar la solicitud mediante proxy. +* **`source`**: El patrón de ruta en tu domain que activa la reescritura. +* **`destination`**: A dónde se debe enrutar por proxy la solicitud. * **`:match*`**: Un comodín que captura cualquier segmento de ruta después de tu subruta. Para obtener más información, consulta [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) en la documentación de Vercel. @@ -56,7 +56,7 @@ Para obtener más información, consulta [Configuring projects with vercel.json: ### Generar redirecciones
-Ingresa tu subdomain y el subdirectorio personalizado para generar las redirecciones para tu archivo `vercel.json`. +Ingresa tu subdomain y el subdirectorio personalizado para generar las redirecciones de tu archivo `vercel.json`. @@ -64,29 +64,29 @@ Ingresa tu subdomain y el subdirectorio personalizado para generar las redirecci ## Uso de proxies externos con Vercel -Si usas un proxy externo (como Cloudflare o AWS CloudFront) delante de tu implementación en Vercel, debes configurarlo correctamente para evitar conflictos con la verificación de domain de Vercel y la provisión de certificados SSL. +Si utilizas un proxy externo (como Cloudflare o AWS CloudFront) delante de tu implementación en Vercel, debes configurarlo correctamente para evitar conflictos con la verificación del domain de Vercel y el aprovisionamiento de certificados SSL. -Una configuración incorrecta del proxy puede impedir que Vercel emita certificados SSL de Let's Encrypt y provocar fallos en la verificación del domain. +Una configuración incorrecta del proxy puede impedir que Vercel aprovisione certificados SSL de Let's Encrypt y provocar fallos en la verificación del domain. Consulta los [proveedores compatibles](https://vercel.com/guides/how-to-setup-verified-proxy#supported-providers-verified-proxy-lite) en la documentación de Vercel.
- ### Lista de rutas obligatorias permitidas + ### Lista obligatoria de rutas permitidas
-Tu proxy externo debe permitir el tráfico a estas rutas específicas sin bloquear, redirigir ni aplicar caché agresiva: +Tu proxy externo debe permitir el tráfico a estas rutas específicas sin bloquear, redirigir ni aplicar un almacenamiento en caché agresivo: - `/.well-known/acme-challenge/*` - Obligatorio para la verificación de certificados de Let's Encrypt -- `/.well-known/vercel/*` - Obligatorio para la verificación del domain en Vercel +- `/.well-known/vercel/*` - Obligatorio para la verificación de domain de Vercel - `/mintlify-assets/_next/static/*` - Obligatorio para los recursos estáticos -Estas rutas deben pasar directamente a tu implementación de Vercel sin modificaciones. +Estas rutas deben pasar directamente a tu implementación en Vercel sin modificaciones.
### Requisitos para el reenvío de encabezados
-Asegúrate de que tu proxy reenvíe correctamente el encabezado `HOST`. Sin un reenvío adecuado del encabezado, las solicitudes de verificación fallarán. +Asegúrate de que tu proxy reenvíe correctamente el encabezado `HOST`. Sin un reenvío adecuado de ese encabezado, las solicitudes de verificación fallarán.
### Probar la configuración de tu proxy @@ -95,5 +95,5 @@ Asegúrate de que tu proxy reenvíe correctamente el encabezado `HOST`. Sin un r Para verificar que tu proxy esté configurado correctamente: 1. Comprueba que `https://[yourdomain].com/.well-known/vercel/` devuelva una respuesta. -2. Asegúrate de que los certificados SSL se aprovisionen correctamente en tu dashboard de Vercel. +2. Asegúrate de que los certificados SSL se estén aprovisionando correctamente en tu dashboard de Vercel. 3. Verifica que la verificación del domain se complete correctamente. \ No newline at end of file diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index 39da4b82a..6f4fa824d 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -1,25 +1,25 @@ --- title: "Menú contextual" -description: "Agrega integraciones de IA con un solo clic a tu documentación" +description: "Añade integraciones de IA con un clic a tu documentación" icon: "square-menu" --- import { PreviewButton } from "/snippets/previewbutton.jsx" import IconsRequired from "/snippets/es/icons-required.mdx"; -El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios abren el menú contextual en cualquier página, pueden copiar contenido para usarlo como contexto en herramientas de IA o iniciar conversaciones en ChatGPT, Claude, Perplexity o una herramienta personalizada de su elección, con su documentación ya cargada como contexto. +El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios abren el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o iniciar conversaciones en ChatGPT, Claude, Perplexity o una herramienta personalizada de su elección, con su documentación ya cargada como contexto. -El menú contextual incluye varias opciones prediseñadas que puedes habilitar añadiendo su identificador a tu configuración. +El menú contextual incluye varias opciones preconfiguradas que puedes habilitar agregando su identificador a tu configuración. | Opción | Identificador | Descripción | |:--------|:------------|:-------------| -| **Copiar página** | `copy` | Copia la página actual como Markdown para pegarla como contexto en herramientas de IA | -| **Ver como Markdown** | `view` | Abre la página actual como Markdown | +| **Copiar página** | `copy` | Copia la página actual en formato Markdown para pegarla como contexto en herramientas de IA | +| **Ver como Markdown** | `view` | Abre la página actual en formato Markdown | | **Abrir en ChatGPT** | `chatgpt` | Crea una conversación en ChatGPT con la página actual como contexto | | **Abrir en Claude** | `claude` | Crea una conversación en Claude con la página actual como contexto | | **Abrir en Perplexity** | `perplexity` | Crea una conversación en Perplexity con la página actual como contexto | @@ -30,12 +30,12 @@ El menú contextual incluye varias opciones prediseñadas que puedes habilitar a El menú contextual expandido que muestra los elementos Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude.
- ## Habilitar el menú contextual + ## Activar el menú contextual
Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones quieres incluir. @@ -75,7 +75,7 @@ Crea opciones personalizadas en el menú contextual agregando un objeto al arreg - El href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de consulta. + El href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de búsqueda. @@ -83,15 +83,15 @@ Crea opciones personalizadas en el menú contextual agregando un objeto al arreg - Los parámetros de consulta de la opción. + Los parámetros de búsqueda de la opción. - La key del parámetro de consulta. + La key del parámetro de búsqueda. - El value del parámetro de consulta. Reemplazaremos los siguientes marcadores con los valores correspondientes: + El value del parámetro de búsqueda. Reemplazaremos los siguientes marcadores de posición por los valores correspondientes: * Usa `$page` para insertar el contenido de la página actual en Markdown. * Usa `$path` para insertar la ruta de la página actual. @@ -133,7 +133,7 @@ Ejemplo de opción personalizada: ```json { - "title": "Solicitar una funcionalidad", + "title": "Solicitar una función", "description": "Únete a la conversación en GitHub", "icon": "plus", "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests" diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx index 11ebb8903..b3835f6dd 100644 --- a/es/ai/llmstxt.mdx +++ b/es/ai/llmstxt.mdx @@ -1,16 +1,16 @@ --- title: "llms.txt" -description: "Haz que tu contenido sea más fácil de leer e indexar para los LLM" +description: "Facilita que los LLM lean e indexen tu contenido" icon: "file-code" --- import { PreviewButton } from "/snippets/previewbutton.jsx" -El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda a los LLM a indexar el contenido de manera más eficiente, similar a cómo un sitemap ayuda a los motores de búsqueda. Las herramientas de IA pueden usar este archivo para comprender la estructura de tu documentación y encontrar contenido relevante para las consultas de los usuarios. +El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda a los LLM a indexar contenido de forma más eficiente, similar a cómo un mapa del sitio ayuda a los motores de búsqueda. Las herramientas de IA pueden usar este archivo para comprender la estructura de tu documentación y encontrar contenido relevante para las consultas de los usuarios. -Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto que enumera todas las páginas disponibles de tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes agregar un `llms.txt` personalizado en la raíz de tu proyecto. +Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto que enumera todas las páginas disponibles en tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes agregar un archivo `llms.txt` personalizado en la raíz de tu proyecto. -Consulta tu `llms.txt` agregando `/llms.txt` a la URL de tu sitio de documentación. +Consulta tu `llms.txt` añadiendo `/llms.txt` a la URL de tu sitio de documentación. Abrir el llms.txt de este sitio. @@ -19,10 +19,10 @@ Consulta tu `llms.txt` agregando `/llms.txt` a la URL de tu sitio de documentaci ## Estructura de llms.txt
-Un archivo `llms.txt` es un archivo Markdown simple que contiene: +Un archivo `llms.txt` es un archivo Markdown de texto plano que contiene: * **Título del sitio** como encabezado H1. -* **Secciones de contenido estructuradas** con enlaces y una descripción de cada página de tu documentación. +* **Secciones de contenido estructurado** con enlaces y una descripción de cada página de tu documentación. ```mdx Example llms.txt # Ejemplo de documentación de producto @@ -35,16 +35,16 @@ Un archivo `llms.txt` es un archivo Markdown simple que contiene: - [API](https://example.com/docs/api): Lista de endpoints y uso ``` -Este enfoque estructurado permite que los LLM procesen tu documentación de forma eficiente a un nivel alto y encuentren contenido relevante para las consultas de los usuarios, mejorando la precisión y la rapidez de las búsquedas de documentación asistidas por IA. +Este enfoque estructurado permite que los LLM procesen tu documentación de forma eficiente a un nivel general y localicen contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.
## llms-full.txt
-El archivo `llms-full.txt` combina todo tu sitio de documentación en un único archivo como contexto para herramientas de IA y es indexado por el tráfico de LLM. +El archivo `llms-full.txt` combina todo tu sitio de documentación en un solo archivo como contexto para herramientas de IA y lo indexa el tráfico de LLM. -Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Visualiza tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. +Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Consulta tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. Abrir el llms-full.txt de este sitio. @@ -54,6 +54,6 @@ Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu pro ## Archivos personalizados -Para agregar un `llms.txt` o `llms-full.txt` personalizado, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Al agregar un archivo personalizado, se reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado. +Para añadir un archivo personalizado `llms.txt` o `llms-full.txt`, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Añadir un archivo personalizado sustituirá el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado. -Tu `llms.txt` o `llms-full.txt` personalizado debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas. +Tu archivo personalizado `llms.txt` o `llms-full.txt` debe tener el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas. diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx index 9d1b5d1eb..370be9fc6 100644 --- a/es/ai/markdown-export.mdx +++ b/es/ai/markdown-export.mdx @@ -1,21 +1,21 @@ --- -title: "Exportación a Markdown" +title: "Exportación de Markdown" description: "Obtén rápidamente versiones en Markdown de las páginas" icon: "file-text" --- import { PreviewButton } from "/snippets/previewbutton.jsx" -Markdown ofrece texto estructurado que las herramientas de IA pueden procesar de forma más eficiente que HTML, lo que se traduce en respuestas más precisas, tiempos de procesamiento más rápidos y un menor consumo de tokens. +Markdown ofrece texto estructurado que las herramientas de IA pueden procesar con más eficiencia que HTML, lo que se traduce en respuestas más precisas, tiempos de procesamiento más rápidos y un menor consumo de tokens. -Mintlify genera automáticamente versiones en Markdown de las páginas, optimizadas para herramientas de IA y para integraciones externas. +Mintlify genera automáticamente versiones en Markdown de las páginas, optimizadas para herramientas de IA e integraciones externas.
## Extensión de URL .md
-Añade `.md` a la URL de cualquier página para ver una versión en Markdown. +Añade `.md` a la URL de cualquier página para ver su versión en Markdown. Abrir esta página en Markdown @@ -25,4 +25,4 @@ Añade `.md` a la URL de cualquier página para ver una versión en Markdown. ## Atajo de teclado -Pulsa Command + C (Ctrl + C en Windows) para copiar una página en Markdown al portapapeles. +Pulsa Command + C (Ctrl + C en Windows) para copiar una página como Markdown al portapapeles. diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index 26310bb90..14aea3c3f 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -1,6 +1,6 @@ --- -title: "Model Context Protocol (MCP)" -description: "Permite que los usuarios accedan a tu documentación y a tus APIs con sus herramientas de IA favoritas" +title: "Model Context Protocol" +description: "Permite que los usuarios accedan a tu documentación y a tus APIs desde sus herramientas de IA favoritas" icon: "audio-waveform" keywords: ["mcp"] --- @@ -11,23 +11,23 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" ## Acerca de los servidores MCP -El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación y especificaciones de OpenAPI, preparando tu contenido para el ecosistema de IA en el que cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación y a tus API. +El Model Context Protocol (MCP) es un protocolo abierto que establece conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación y especificaciones de OpenAPI, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación y a tus APIs. -Tu servidor MCP expone herramientas para que las aplicaciones de IA busquen en tu documentación e interactúen con tus API. +Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación e interactuar con tus APIs.
## Acceder a tu servidor MCP
- Los servidores MCP solo se pueden generar para documentación pública. No se puede acceder a la documentación protegida por autenticación de usuario final para la generación del servidor. + Los servidores MCP solo pueden generarse para documentación pública. No se puede acceder a la documentación detrás de la autenticación del usuario final para generar el servidor. Mintlify genera automáticamente un servidor MCP para tu documentación y lo aloja en la URL de tu documentación con la ruta `/mcp`. Por ejemplo, el servidor MCP de Mintlify está disponible en `https://mintlify.com/docs/mcp`. Puedes ver y copiar la URL de tu servidor MCP en tu [dashboard](https://dashboard.mintlify.com/products/mcp). -La ruta `/mcp` está reservada para servidores MCP alojados y no se puede usar para otros elementos de navegación. +La ruta `/mcp` está reservada para servidores MCP alojados y no se puede usar para otros elementos de navigation.
## Configuración de tu servidor MCP @@ -39,14 +39,14 @@ Si tienes un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=mcp), pued Para exponer endpoints como herramientas MCP, utiliza el objeto `mcp` dentro de la extensión `x-mint` a nivel de archivo o de endpoint. Por ejemplo, el servidor MCP de Mintlify incluye herramientas para crear chats del assistant, obtener actualizaciones de estado y activar actualizaciones. -Los servidores MCP siguen un enfoque de seguridad primero en el que los endpoints de la API no se exponen por defecto. Debes habilitar explícitamente los endpoints para que estén disponibles como herramientas MCP. Expón únicamente los endpoints que sean seguros para el acceso público mediante herramientas de IA. +Los servidores MCP siguen un enfoque de seguridad primero en el que los endpoints de la API no se exponen por defecto. Debes habilitar explícitamente los endpoints para ponerlos a disposición como herramientas MCP. Solo expón endpoints que sean seguros para el acceso público a través de herramientas de IA. La configuración de MCP para el endpoint. - Indica si se debe exponer el endpoint como herramienta MCP. Tiene prioridad sobre la configuración a nivel de archivo. + Indica si se debe exponer el endpoint como una herramienta MCP. Tiene prioridad sobre la configuración a nivel de archivo. @@ -63,7 +63,7 @@ Los servidores MCP siguen un enfoque de seguridad primero en el que los endpoint ### Configuración a nivel de archivo
-Habilita el Model Context Protocol (MCP) para todos los endpoints de forma predeterminada en un archivo de especificación de OpenAPI y excluye selectivamente los endpoints: +Habilita MCP para todos los endpoints de forma predeterminada en un archivo de especificación de OpenAPI y excluye endpoints de manera selectiva: ```json { @@ -93,7 +93,7 @@ Habilita el Model Context Protocol (MCP) para todos los endpoints de forma prede ### Configuración a nivel de endpoint -Habilita Model Context Protocol (MCP) para endpoints específicos: +Activa Model Context Protocol (MCP) para endpoints específicos: ```json { @@ -112,7 +112,7 @@ Habilita Model Context Protocol (MCP) para endpoints específicos: }, "/api/v1/delete": { "delete": { - // No hay `x-mint: mcp`, por lo que este endpoint no se expone como una herramienta MCP + // No `x-mint: mcp` así que este endpoint no se expone como herramienta MCP // ... } } @@ -126,9 +126,9 @@ Habilita Model Context Protocol (MCP) para endpoints específicos: Tus usuarios deben conectar tu servidor MCP a sus herramientas de IA preferidas. -1. Publica la URL de tu servidor MCP para que sea accesible públicamente. +1. Haz que la URL de tu servidor MCP sea pública. 2. Los usuarios copian la URL de tu servidor MCP y la añaden a sus herramientas. -3. Los usuarios acceden a tu documentación y a los endpoints de la API desde sus herramientas. +3. Los usuarios acceden a tu documentación y a los endpoints de tu API desde sus herramientas. Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu servidor MCP: @@ -146,17 +146,17 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s - Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y localiza la URL de tu servidor MCP. + Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP. Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y los pasos para conectarlo a Claude. - 1. Ve a la página [Connectors](https://claude.ai/settings/connectors) en la configuración de Claude. + 1. Ve a la página de [Connectors](https://claude.ai/settings/connectors) en la configuración de Claude. 2. Selecciona **Add custom connector**. 3. Agrega el nombre y la URL de tu servidor MCP. 4. Selecciona **Add**. - 5. Al usar Claude, selecciona el botón de adjuntos (el icono con el signo más). + 5. Al usar Claude, selecciona el botón de adjuntos (el ícono de más). 6. Selecciona tu servidor MCP. @@ -167,7 +167,7 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s - Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y localiza la URL de tu servidor MCP. + Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP. @@ -185,7 +185,7 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s - Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y localiza la URL de tu servidor MCP. + Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP. @@ -193,7 +193,7 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s 1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. 2. Busca "Open MCP settings". - 3. Selecciona **Add custom MCP**. Se abrirá el archivo `mcp.json`. + 3. Selecciona **Add custom MCP**. Esto abrirá el archivo `mcp.json`. 4. En `mcp.json`, configura tu servidor: ```json @@ -214,7 +214,7 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s - Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y localiza la URL de tu servidor MCP. + Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP. @@ -241,21 +241,21 @@ Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu s
- ### Ejemplo: Conexión al servidor MCP de Mintlify + ### Ejemplo: Conectarse al servidor MCP de Mintlify
-Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y buscar en nuestra documentación. Esto te dará respuestas más precisas sobre cómo usar Mintlify en tu entorno local y mostrará cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP. +Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y buscar en nuestra documentación. Esto te dará respuestas más precisas sobre cómo usar Mintlify en tu entorno local y demuestra cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP. - - En la parte superior de esta página, selecciona el menú contextual y elige **Connect to Cursor** o **Connect to VS Code** para conectar el servidor MCP de Mintlify al IDE de tu preferencia. + + En la parte superior de esta página, selecciona el menú contextual y elige **Connect to Cursor** o **Connect to VS Code** para conectar el servidor MCP de Mintlify con el IDE de tu preferencia. Para usar el servidor MCP de Mintlify con Claude: - + 1. Ve a la página [Connectors](https://claude.ai/settings/connectors) en la configuración de Claude. 2. Selecciona **Add custom connector**. 3. Agrega el servidor MCP de Mintlify: @@ -266,8 +266,8 @@ Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y 4. Selecciona **Add**. - - 1. Al usar Claude, selecciona el botón de adjuntos (el ícono de más). + + 1. Cuando uses Claude, selecciona el botón de adjuntos (el icono de suma). 2. Selecciona el servidor MCP de Mintlify. 3. Hazle a Claude una pregunta sobre Mintlify. @@ -295,16 +295,16 @@ Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y Install in Cursor - Para conectar el servidor MCP de Mintlify a Cursor, haz clic en el botón **Install in Cursor**. O, para conectarlo manualmente, sigue estos pasos: + Para conectar el servidor MCP de Mintlify a Cursor, haz clic en el botón **Install in Cursor**. O, para conectar el servidor MCP manualmente, sigue estos pasos: - + 1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos. 2. Busca "Open MCP settings". 3. Selecciona **Add custom MCP**. Esto abrirá el archivo `mcp.json`. - + En `mcp.json`, agrega: ```json @@ -318,7 +318,7 @@ Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y ``` - + En el chat de Cursor, pregunta "What tools do you have available?" Cursor debería mostrar el servidor MCP de Mintlify como una herramienta disponible. @@ -329,7 +329,7 @@ Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y Install in VS Code - Para conectar el servidor MCP de Mintlify a VS Code, haz clic en el botón **Install in VS Code**. O, para conectarlo manualmente, crea un archivo `.vscode/mcp.json` y agrega: + Para conectar el servidor MCP de Mintlify a VS Code, haz clic en el botón **Install in VS Code**. O, para conectar el servidor MCP manualmente, crea un archivo `.vscode/mcp.json` y agrega: ```json { @@ -350,12 +350,12 @@ Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y ## Autenticación -Cuando habilitas un endpoint de API para Model Context Protocol (MCP), el servidor incluye los requisitos de autenticación definidos en tu OpenAPI en `securitySchemes` y `securityRequirement`. Cualquier key es gestionada directamente por la herramienta y no se almacena ni procesa en Mintlify. +Cuando habilitas un endpoint de API para MCP, el servidor incluye los requisitos de autenticación definidos en los campos `securitySchemes` y `securityRequirement` de tu especificación OpenAPI. Cualquier key es gestionada directamente por la herramienta y no es almacenada ni procesada por Mintlify. -Si un usuario le pide a su herramienta de IA que invoque un endpoint protegido, la herramienta solicitará en ese momento las credenciales de autenticación necesarias al usuario. +Si un usuario le pide a su herramienta de IA que invoque un endpoint protegido, la herramienta solicitará en ese momento al usuario las credenciales de autenticación necesarias.
- ## Supervisión de tu servidor MCP + ## Supervisar tu servidor MCP
Puedes ver todas las herramientas MCP disponibles en la sección **Available tools** de la [página del MCP Server](https://dashboard.mintlify.com/products/mcp) en tu dashboard. @@ -382,17 +382,17 @@ Puedes ver todas las herramientas MCP disponibles en la sección **Available too - Si los usuarios reportan problemas de autenticación: + Si los usuarios informan problemas de autenticación: 1. Verifica que tu especificación OpenAPI incluya definiciones correctas de `securitySchemes`. 2. Confirma que los endpoints habilitados funcionen con los métodos de autenticación especificados. - Si las herramientas de IA no están utilizando tus endpoints de API de manera efectiva: + Si las herramientas de IA no están usando tus endpoints de API de manera efectiva: 1. Agrega campos `summary` y `description` detallados a tus endpoints. - 2. Asegúrate de que los nombres y las descripciones de los parámetros sean claros por sí mismos. + 2. Asegúrate de que los nombres y descripciones de los parámetros sean claros por sí mismos. 3. Usa el dashboard de MCP para verificar cómo aparecen tus endpoints como herramientas. \ No newline at end of file diff --git a/es/ai/slack-app.mdx b/es/ai/slack-app.mdx index b9cd3ebc0..4fffc0486 100644 --- a/es/ai/slack-app.mdx +++ b/es/ai/slack-app.mdx @@ -1,6 +1,6 @@ --- title: "Slack app" -description: "Añade un bot que busca en tu documentación para responder preguntas en tu espacio de trabajo de Slack" +description: "Agrega un bot que busca en tu documentación para responder preguntas en tu espacio de trabajo de Slack" icon: "slack" --- @@ -8,23 +8,23 @@ icon: "slack" La aplicación de Slack está disponible para los [planes Pro y Custom](https://mintlify.com/pricing?ref=slack-app). -La aplicación de Slack añade un bot llamado `@mintlify` a tu espacio de trabajo de Slack que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, @menciones y a cualquier pregunta en un canal llamado específicamente `#ask-ai`. +La aplicación de Slack agrega un bot llamado `@mintlify` a tu espacio de trabajo de Slack que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, menciones con @ y a cualquier pregunta en un canal específicamente llamado `#ask-ai`. -La aplicación de Slack puede generar costos: ya sea usando tus créditos del Asistente de IA o incurriendo en excedentes. +La aplicación de Slack puede generar costos: ya sea utilizando tus créditos del Asistente de IA o incurriendo en excedentes.
## Configurar la aplicación de Slack
- Si el propietario de tu espacio de trabajo de Slack requiere la aprobación de un administrador para instalar aplicaciones, pídele que apruebe la aplicación de Slack de Mintlify antes de que la agregues. + Si el propietario de tu espacio de trabajo de Slack requiere aprobación de administrador para instalar aplicaciones, pídele que apruebe la aplicación de Slack de Mintlify antes de agregarla. 1. Ve a la página de [Add-ons](https://dashboard.mintlify.com/products/addons) de tu dashboard. 2. Selecciona **Connect** en la tarjeta Slack Integration. 3. Sigue las indicaciones de Slack para agregar la aplicación a tu espacio de trabajo. -4. Verifica que el bot funcione y responda cuando: +4. Verifica que el bot funciona y responde cuando: -- Le envíes un mensaje directo a la aplicación de Mintlify. - - Menciones al bot con `@mintlify` en un canal. - - Crees un canal `#ask-ai`, agregues al bot y hagas una pregunta. \ No newline at end of file +- Envías un mensaje directo a la aplicación de Mintlify. + - Mencionas al bot con `@mintlify` en un canal. + - Creas un canal `#ask-ai`, agregas el bot y haces una pregunta. \ No newline at end of file diff --git a/es/analytics/feedback.mdx b/es/analytics/feedback.mdx index ffef0eadc..d7e4b1149 100644 --- a/es/analytics/feedback.mdx +++ b/es/analytics/feedback.mdx @@ -4,10 +4,10 @@ description: "Supervisa la satisfacción de los usuarios con tu documentación" --- - Para recopilar y ver el feedback, primero debes habilitarlo desde la página de [Add-ons](https://dashboard.mintlify.com/products/addons) en tu dashboard. + Para recopilar y ver feedback, primero debes habilitarlo desde la página de [Add-ons](https://dashboard.mintlify.com/products/addons) en tu dashboard. -La Tab de feedback muestra los votos cuantitativos de pulgar arriba y pulgar abajo que ha recibido tu documentación y cualquier feedback cualitativo que hayan proporcionado los usuarios. Usa esta información para evaluar la calidad de tu documentación y realizar mejoras. +La Tab de feedback muestra el recuento de votos positivos y negativos que han recibido tus docs y cualquier feedback cualitativo que hayan proporcionado los usuarios. Usa esta información para evaluar la calidad de tus docs y realizar mejoras. Accede a la Tab de feedback desde la página de **Analytics** en tu [dashboard](https://dashboard.mintlify.com/products/analytics). @@ -16,12 +16,12 @@ Accede a la Tab de feedback desde la página de **Analytics** en tu [dashboard]( - Los comentarios contextuales y de fragmentos de código están en beta. Para habilitarlos en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). + Los comentarios contextuales y en fragmentos de código están en beta. Para habilitarlos en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). La Tab de comentarios muestra información según los Add-ons de comentarios que habilites. -Activa tus tipos de comentarios preferidos: +Habilita los tipos de comentarios que prefieras: @@ -39,30 +39,30 @@ Activa tus tipos de comentarios preferidos: -* **Solo valoración con pulgares**: Votación simple de pulgar arriba/abajo para medir la satisfacción general con las páginas. +* **Solo valoración con pulgares**: Votación simple con pulgar arriba/abajo para medir la satisfacción general con las páginas. * **Solo comentarios sobre fragmentos de código**: Comentarios específicamente sobre fragmentos de código. * **Valoración con pulgares y comentarios contextuales**: Votación de la página más comentarios detallados y motivos de las valoraciones. * **Valoración con pulgares y comentarios sobre fragmentos de código**: Votación de la página más comentarios sobre ejemplos de código. -* **Valoración con pulgares, comentarios contextuales y comentarios sobre fragmentos de código**: Sistema de comentarios completo con votación de la página, comentarios detallados y comentarios sobre fragmentos de código. +* **Valoración con pulgares, comentarios contextuales y sobre fragmentos de código**: Sistema de comentarios completo con votación de la página, comentarios detallados y comentarios sobre fragmentos de código.
## Gestión de comentarios
-Para los comentarios contextuales y sobre fragmentos de código, puedes establecer el estado de cada comentario y añadir notas internas para hacer un seguimiento de tu trabajo al resolver la retroalimentación de los usuarios. +Para los comentarios contextuales y sobre fragmentos de código, puedes establecer el estado de cada comentario y añadir notas internas para hacer seguimiento del trabajo de resolución de los comentarios de los usuarios.
- ### Cambiar el estado de los comentarios + ### Cambiar el estado del feedback
Selecciona el estado junto a un comentario para marcarlo como **Pendiente**, **En progreso**, **Resuelto** o **Descartado**. -Mejores prácticas para establecer estados: +Mejores prácticas para definir los estados del feedback: -* **Pendiente**: El comentario está en espera de revisión. -* **En progreso**: El comentario ha sido validado y se está trabajando en él. -* **Resuelto**: El comentario se ha resuelto. -* **Descartado**: El comentario se ha descartado por no ser procesable, por ser irrelevante o por ser inexacto. +* **Pendiente**: El feedback está a la espera de revisión. +* **En progreso**: El feedback ha sido validado y se está trabajando en él. +* **Resuelto**: El feedback se ha resuelto. +* **Descartado**: El feedback se ha descartado por no ser procesable, por irrelevante o por inexacto.
### Filtrar por estado @@ -76,14 +76,14 @@ Usa el filtro de estado para controlar qué comentarios se muestran. Desmarca un Haz clic en un comentario para agregar una nota interna. Estas notas solo son visibles para las personas con acceso a tu dashboard. -Usa las notas para añadir información que facilite la colaboración, vincular tickets relevantes de soporte o de ingeniería, o recordar cualquier otra información útil. +Usa las notas para añadir información para colaborar, vincular tickets relevantes de soporte o ingeniería, o registrar cualquier otra información útil.
## Uso de los datos de comentarios
-Revisa tus datos de comentarios para: +Revisa los datos de comentarios para: * **Identificar el contenido que funciona**: Las páginas con más comentarios positivos muestran qué funciona bien en tu documentación. * **Priorizar mejoras**: Las páginas con más comentarios negativos indican qué contenido podría requerir atención. - * **Tomar acción**: Realiza actualizaciones en la documentación basadas en comentarios directos de los usuarios. \ No newline at end of file + * **Actuar**: Realiza actualizaciones en la documentación basadas en comentarios directos de los usuarios. \ No newline at end of file diff --git a/es/analytics/improving-docs.mdx b/es/analytics/improving-docs.mdx index b186e29d3..32884af38 100644 --- a/es/analytics/improving-docs.mdx +++ b/es/analytics/improving-docs.mdx @@ -6,35 +6,35 @@ description: "Usa datos de Analytics para mejorar tu documentación" Mejora tu documentación a partir de datos cuantitativos y cualitativos de tu dashboard de Analytics.
- ## Información interanálisis + ## Insights entre Analytics
-Combina datos de múltiples fuentes de Analytics para obtener una visión integral de tu documentación. +Combina información de múltiples fuentes de Analytics para obtener una visión integral de tu documentación.
- ### Correlaciona el tráfico y la satisfacción + ### Correlaciona tráfico y satisfacción
-- **Mucho tráfico y bajas valoraciones de feedback**: Páginas populares con una mala experiencia de usuario. Prioriza mejorar estas páginas. -- **Poco tráfico y altas valoraciones de feedback**: Documentación que funciona bien, pero puede que no se esté encontrando. Considera promocionar estas páginas. -- **Mucho tráfico y altas valoraciones de feedback**: Los mayores éxitos de tu documentación. Revisa estas páginas para inspirarte y mejorar el resto de tu contenido. +- **Alto tráfico y bajas valoraciones**: Páginas populares con una experiencia de usuario deficiente. Prioriza mejorar estas páginas. +- **Bajo tráfico y altas valoraciones**: Documentación que funciona bien, pero puede no ser fácil de descubrir. Considera promocionar estas páginas. +- **Alto tráfico y altas valoraciones**: Los mayores éxitos de tu documentación. Revisa estas páginas para inspirarte y mejorar el resto de tu contenido.
### Alinea la intención de búsqueda con el rendimiento del contenido
-- **Alto volumen de búsqueda y pocas páginas vistas**: Problemas de descubrimiento. Considera reubicar estas páginas o revisar su frontmatter. -- **Términos de búsqueda populares y resultados con baja confianza**: Oportunidad por brecha de contenido. Considera agregar más contenido o crear contenido nuevo sobre estos temas. -- **Búsquedas más populares y comentarios negativos en las páginas correspondientes**: Problemas de experiencia de usuario. Revisa las páginas para comprobar si resuelven la necesidad del usuario que motivó la búsqueda. +- **Alto volumen de búsqueda y pocas vistas de página**: Problemas de descubrimiento. Considera reubicar estas páginas o revisar su frontmatter. +- **Términos de búsqueda populares y resultados con baja confianza**: Oportunidad por brecha de contenido. Considera agregar más contenido o nuevo contenido sobre estos temas. +- **Búsquedas más populares y comentarios negativos en las páginas correspondientes**: Problemas de experiencia del usuario. Revisa las páginas para ver si responden a la necesidad del usuario que motivó la búsqueda.
- ## Convierte las métricas en acciones + ## Convierte las ideas en acción
-Usa estos patrones de análisis cruzado para priorizar las mejoras de tu documentación: +Usa estos patrones de Analytics combinados para priorizar las mejoras de tu documentación: -- **Soluciona primero los problemas de mayor impacto**: Las páginas populares con malas valoraciones afectan a más usuarios. -- **Cubre brechas de contenido verificadas**: Las búsquedas con baja confianza y alto volumen indican necesidades de los usuarios no cubiertas. +- **Soluciona primero los problemas de mayor impacto**: Las páginas populares con malas calificaciones de feedback afectan a más usuarios. +- **Cubre las brechas de contenido confirmadas**: Las búsquedas de baja confianza y alto volumen indican necesidades de los usuarios no satisfechas. - **Responde al feedback de los usuarios**: El feedback contextual y sobre fragmentos de código puede señalar áreas específicas de mejora. - **Alinea la búsqueda con el contenido**: Asegúrate de que tus temas más buscados tengan páginas completas y bien organizadas. -- **Supervisa las tendencias de búsqueda al alza sin páginas populares existentes**: Nuevas oportunidades de contenido. \ No newline at end of file +- **Supervisa las tendencias de búsqueda en alza sin páginas populares existentes**: Nuevas oportunidades de contenido. \ No newline at end of file diff --git a/es/analytics/overview.mdx b/es/analytics/overview.mdx index 0ee1dd0ec..f4b180dde 100644 --- a/es/analytics/overview.mdx +++ b/es/analytics/overview.mdx @@ -1,11 +1,11 @@ --- -title: "Overview" -description: "Consulta el tráfico y obtén información general sobre tu documentación" +title: "Descripción general" +description: "Consulta el tráfico y las métricas clave de tu documentación" --- -La Tab de Overview muestra cuántas personas han visitado tu documentación, cuáles son las páginas más populares y de dónde vienen los usuarios. Usa esta información para identificar qué páginas aportan más valor a tus usuarios y para seguir las tendencias a lo largo del tiempo. +La pestaña de descripción general muestra cuántas personas han visitado tu documentación, qué páginas son las más populares y de dónde provienen los usuarios. Usa esta información para identificar qué páginas aportan más valor a tus usuarios y para seguir las tendencias a lo largo del tiempo. -Accede a las métricas de Overview desde la página de **Analytics** en tu [dashboard](https://dashboard.mintlify.com/products/analytics). +Accede a las métricas de descripción general desde la página de **Analytics** en tu [dashboard](https://dashboard.mintlify.com/products/analytics).
## Métricas @@ -13,17 +13,17 @@ Accede a las métricas de Overview desde la página de **Analytics** en tu [dash Usa el selector de rango para ajustar el período de tiempo de los datos mostrados. Selecciona visitantes, vistas o acciones para mostrar un gráfico de líneas con las tendencias durante el período seleccionado. -- **Visitantes**: Visitantes únicos -- **Vistas**: Total de páginas vistas -- **Acciones**: Recuento combinado de llamadas a la API, clics en enlaces de la barra de navegación y clics en botones de llamada a la acción -- **Páginas populares**: Rutas a las páginas más visitadas y su número de vistas -- **Referencias**: Principales fuentes de tráfico que dirigen usuarios a tu documentación +- **Visitors**: Visitantes únicos +- **Views**: Total de visualizaciones de página +- **Actions**: Recuento combinado de llamadas a la API, clics en enlaces de la barra de navegación y clics en botones de llamada a la acción +- **Popular Pages**: Rutas a las páginas más visitadas y su número de visualizaciones +- **Referrers**: Principales fuentes de tráfico que dirigen usuarios a tu documentación
## Uso de los datos de la vista general
-Revisa tus Analytics de la vista general para: +Revisa los Analytics de la vista general para: -- **Identificar páginas populares**: Usa las páginas populares para entender qué contenido es más importante para tus usuarios y asegurarte de que esté actualizado y completo. -- **Seguir las tendencias de tráfico**: Supervisa los cambios en el tráfico para comprender el impacto de las actualizaciones o del nuevo contenido. \ No newline at end of file +- **Identificar páginas populares**: Usa las páginas populares para entender qué contenido es más importante para tus usuarios y asegurarte de que esté actualizado y sea completo. +- **Seguir tendencias de tráfico**: Supervisa los cambios en el tráfico para comprender el impacto de las actualizaciones o del contenido nuevo. \ No newline at end of file diff --git a/es/analytics/search.mdx b/es/analytics/search.mdx index a5ec4ce0b..ca822fc6e 100644 --- a/es/analytics/search.mdx +++ b/es/analytics/search.mdx @@ -1,9 +1,9 @@ --- title: "Búsqueda" -description: "Comprende cómo los usuarios buscan en tu documentación" +description: "Entiende cómo los usuarios buscan dentro de tu documentación" --- -Utiliza los datos de la Tab de búsqueda para entender qué buscan los usuarios e identificar temas que deban actualizarse o ampliarse. +Utiliza los datos en la Tab de búsqueda para comprender qué están buscando los usuarios e identificar los temas que necesitan actualizarse o ampliarse. Accede a tus métricas de búsqueda desde la página de **Analytics** en tu [dashboard](https://dashboard.mintlify.com/products/analytics). @@ -13,9 +13,9 @@ Accede a tus métricas de búsqueda desde la página de **Analytics** en tu [das Usa el selector de rango para ajustar el periodo de tiempo de los datos mostrados. -- **Total queries**: Volumen de búsquedas +- **Consultas totales**: Volumen de búsqueda - **Búsquedas más populares**: Términos más buscados -- **Low-confidence searches**: Búsquedas con baja confianza +- **Búsquedas de baja confianza**: Consultas que podrían no haber arrojado resultados relevantes
## Uso de los datos de búsqueda @@ -23,6 +23,6 @@ Usa el selector de rango para ajustar el periodo de tiempo de los datos mostrado Revisa tus Analytics de búsqueda para: -- **Identificar temas populares**: Usa las Búsquedas más populares para entender qué contenido buscan las personas. -- **Detectar vacíos de contenido**: Las búsquedas con baja confianza pueden indicar documentación faltante o temas que requieren mejor cobertura. -- **Mejorar la capacidad de descubrimiento**: Asegúrate de que las páginas que coincidan con los términos de búsqueda populares sean fáciles de encontrar y estén bien organizadas. \ No newline at end of file +- **Identificar temas populares**: Usa Búsquedas más populares para entender qué contenido busca la gente. +- **Detectar vacíos de contenido**: Las búsquedas con baja confianza pueden indicar que falta documentación o que hay temas que requieren una mejor cobertura. +- **Mejorar la capacidad de descubrimiento**: Asegúrate de que las páginas que coinciden con términos de búsqueda populares sean fáciles de encontrar y estén bien organizadas. \ No newline at end of file diff --git a/es/api-playground/asyncapi/playground.mdx b/es/api-playground/asyncapi/playground.mdx index d193274c2..1c0c31a02 100644 --- a/es/api-playground/asyncapi/playground.mdx +++ b/es/api-playground/asyncapi/playground.mdx @@ -1,5 +1,5 @@ --- -title: "Playground" -description: "Permite que los usuarios interactúen con tus WebSockets" +title: "Zona de pruebas" +description: "Permite que los usuarios interactúen con tus websockets" asyncapi: "/asyncapi.yaml channelOne" --- diff --git a/es/api-playground/asyncapi/setup.mdx b/es/api-playground/asyncapi/setup.mdx index 4daa010a7..1991ce124 100644 --- a/es/api-playground/asyncapi/setup.mdx +++ b/es/api-playground/asyncapi/setup.mdx @@ -6,10 +6,10 @@ description: "Crea páginas de referencia de WebSocket con AsyncAPI"
- ## Agrega un archivo de especificación de AsyncAPI + ## Añade un archivo de especificación de AsyncAPI
-Para empezar a crear páginas para tus websockets, asegúrate de tener un documento de esquema de AsyncAPI válido en formato JSON o YAML que cumpla con la [especificación de AsyncAPI](https://www.asyncapi.com/docs/reference/specification/v3.0.0). Tu esquema debe cumplir con la especificación de AsyncAPI 3.0+. +Para empezar a crear páginas para tus websockets, asegúrate de contar con un documento de esquema de AsyncAPI válido en formato JSON o YAML que cumpla con la [especificación de AsyncAPI](https://www.asyncapi.com/docs/reference/specification/v3.0.0). Tu esquema debe ajustarse a la especificación de AsyncAPI 3.0 o superior. Para verificar que tu esquema de AsyncAPI sea válido, puedes pegarlo en @@ -19,10 +19,10 @@ Para empezar a crear páginas para tus websockets, asegúrate de tener un docume
- ## Rellenar automáticamente páginas de websockets + ## Autogenerar páginas de websockets
-Puedes añadir un campo `asyncapi` a cualquier Tab o grupo en la navigation de tu `docs.json`. Este campo puede contener la ruta a un documento de esquema de AsyncAPI en tu repositorio de documentación, la URL de un documento de esquema de AsyncAPI alojado, o una matriz de enlaces a documentos de esquema de AsyncAPI. Mintlify generará automáticamente una página para cada canal websocket de AsyncAPI. +Puedes agregar un campo `asyncapi` a cualquier tab o grupo en la navigation de tu `docs.json`. Este campo puede contener la ruta a un documento de esquema de AsyncAPI en tu repositorio de documentación, la URL de un documento de esquema de AsyncAPI hospedado o un arreglo de enlaces a documentos de esquema de AsyncAPI. Mintlify generará automáticamente una página para cada canal de websocket de AsyncAPI. **Ejemplos con Tabs:** @@ -51,7 +51,7 @@ Puedes añadir un campo `asyncapi` a cualquier Tab o grupo en la navigation de t ``` -**Ejemplos con groups:** +**Ejemplos con Groups:** ```json {8-11} "navigation": { @@ -74,7 +74,7 @@ Puedes añadir un campo `asyncapi` a cualquier Tab o grupo en la navigation de t El campo directory es opcional. Si no se especifica, los archivos se ubicarán en - la carpeta **api-reference** del repositorio de documentación. + la carpeta **api-reference** del repositorio de docs. @@ -82,7 +82,7 @@ Puedes añadir un campo `asyncapi` a cualquier Tab o grupo en la navigation de t ## Página de canal
-Si quieres tener más control sobre el orden de tus canales o si solo necesitas referirte a un canal específico, puedes crear un archivo MDX con el campo `asyncapi` en el frontmatter. +Si quieres tener más control sobre el orden de tus canales, o si solo quieres hacer referencia a un canal específico, puedes crear un archivo MDX con el campo `asyncapi` en el frontmatter. ```mdx --- diff --git a/es/api-playground/customization/adding-sdk-examples.mdx b/es/api-playground/customization/adding-sdk-examples.mdx index 3ebbaaa93..998496a30 100644 --- a/es/api-playground/customization/adding-sdk-examples.mdx +++ b/es/api-playground/customization/adding-sdk-examples.mdx @@ -3,12 +3,12 @@ title: "Agregar ejemplos de SDK" description: "Muestra fragmentos de código específicos por idioma junto a tus endpoints de API para enseñar a los desarrolladores cómo usar tus SDK" --- -Si tus usuarios interactúan con tu API mediante un SDK en lugar de hacerlo directamente a través de una solicitud de red, puedes usar la extensión `x-codeSamples` para agregar fragmentos de código a tu documento de OpenAPI y mostrarlos en tus páginas de OpenAPI. +Si tus usuarios interactúan con tu API mediante un SDK en lugar de directamente a través de una solicitud de red, puedes usar la extensión `x-codeSamples` para agregar ejemplos de código a tu documento de OpenAPI y mostrarlos en tus páginas de OpenAPI. Esta propiedad se puede agregar a cualquier método de solicitud y tiene el siguiente esquema. - El idioma del fragmento de código. + El idioma del ejemplo de código. diff --git a/es/api-playground/customization/complex-data-types.mdx b/es/api-playground/customization/complex-data-types.mdx index df24413a3..4359dbe1c 100644 --- a/es/api-playground/customization/complex-data-types.mdx +++ b/es/api-playground/customization/complex-data-types.mdx @@ -1,9 +1,9 @@ --- title: "Tipos de datos complejos" -description: "Describe APIs con esquemas flexibles, propiedades opcionales y múltiples formatos de datos usando las palabras clave `oneOf`, `anyOf` y `allOf`" +description: "Describe APIs con esquemas flexibles, propiedades opcionales y múltiples formatos de datos usando los keywords `oneOf`, `anyOf` y `allOf`" --- -Cuando tu API admite múltiples formatos de datos, tiene campos condicionales o utiliza patrones de herencia, las palabras clave de composición de esquemas de OpenAPI te ayudan a documentar estas estructuras flexibles. Con `oneOf`, `anyOf` y `allOf`, puedes describir APIs que aceptan distintos tipos de entrada o combinan múltiples esquemas en modelos de datos completos. +Cuando tu API acepta varios formatos de datos, tiene campos condicionales o utiliza patrones de herencia, los keywords de composición de esquemas de OpenAPI te ayudan a documentar estas estructuras flexibles. Con `oneOf`, `anyOf` y `allOf`, puedes describir APIs que procesan distintos tipos de entrada o combinan varios esquemas en modelos de datos completos. @@ -13,13 +13,13 @@ Cuando tu API admite múltiples formatos de datos, tiene campos condicionales o Para tipos de datos complejos, OpenAPI proporciona palabras clave para combinar esquemas: -* `allOf`: Combina varios esquemas (como fusionar objetos o extender un esquema base). Funciona como un operador `and`. -* `anyOf`: Acepta datos que coincidan con cualquiera de los esquemas proporcionados. Funciona como un operador `or`. -* `oneOf`: Acepta datos que coincidan exactamente con uno de los esquemas proporcionados. Funciona como un operador `exclusive-or`. +* `allOf`: Combina varios esquemas (como fusionar objetos o extender un esquema base). Opera como un operador `and`. +* `anyOf`: Acepta datos que coincidan con cualquiera de los esquemas proporcionados. Opera como un operador `or`. +* `oneOf`: Acepta datos que coincidan exactamente con uno de los esquemas proporcionados. Opera como un operador `exclusive-or`. -Mintlify trata `oneOf` y `anyOf` de forma idéntica, ya que la diferencia práctica rara vez afecta el uso de la API. +Mintlify trata `oneOf` y `anyOf` de manera idéntica, ya que la diferencia práctica rara vez afecta el uso de la API. -Para ver las especificaciones detalladas de estas palabras clave, consulta la [documentación de OpenAPI](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/). +Para consultar las especificaciones detalladas de estas palabras clave, revisa la [documentación de OpenAPI](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/). La palabra clave `not` no es compatible actualmente. @@ -27,7 +27,7 @@ Para ver las especificaciones detalladas de estas palabras clave, consulta la [d ### Combinación de esquemas con `allOf`
-Cuando usas `allOf`, Mintlify realiza un preprocesamiento en tu documento de OpenAPI para mostrar combinaciones complejas de forma legible. Por ejemplo, cuando combinas dos esquemas de objeto con `allOf`, Mintlify une las propiedades de ambos en un único objeto. Esto resulta especialmente útil al aprovechar los [components](https://swagger.io/docs/specification/components/) reutilizables de OpenAPI. +Cuando usas `allOf`, Mintlify realiza cierto preprocesamiento en tu documento de OpenAPI para mostrar combinaciones complejas de manera legible. Por ejemplo, cuando combinas dos esquemas de objeto con `allOf`, Mintlify unifica las propiedades de ambos en un solo objeto. Esto resulta especialmente útil al aprovechar los [components](https://swagger.io/docs/specification/components/) reutilizables de OpenAPI. ```yaml org_with_users: @@ -56,7 +56,7 @@ components: - Una matriz que contiene a todos los usuarios de la organización + Un arreglo que contiene a todos los usuarios de la organización @@ -65,7 +65,7 @@ components: ### Proporcionar opciones con `oneOf` y `anyOf`
-Cuando uses `oneOf` o `anyOf`, las opciones se muestran en un contenedor con pestañas. Especifica un campo `title` en cada subesquema para poner nombre a las opciones. Por ejemplo, así podrías mostrar dos tipos distintos de direcciones de entrega: +Cuando usas `oneOf` o `anyOf`, las opciones se muestran en un contenedor con pestañas. Especifica un campo `title` en cada subesquema para asignar nombres a tus opciones. Por ejemplo, así podrías mostrar dos tipos diferentes de direcciones de entrega: ```yaml delivery_address: @@ -91,7 +91,7 @@ delivery_address: - La dirección de la residencia + La dirección de la vivienda diff --git a/es/api-playground/customization/managing-page-visibility.mdx b/es/api-playground/customization/managing-page-visibility.mdx index 8a134284e..d3d7eafb6 100644 --- a/es/api-playground/customization/managing-page-visibility.mdx +++ b/es/api-playground/customization/managing-page-visibility.mdx @@ -1,11 +1,11 @@ --- -title: "Gestionar la visibilidad de las páginas" +title: "Administrar la visibilidad de las páginas" description: "Controla qué endpoints de tu especificación de OpenAPI aparecen en la navegación de tu documentación" --- -Puedes controlar qué operaciones de OpenAPI se publican como páginas de documentación y su visibilidad en la navegación. Esto es útil para endpoints internos, operaciones en desuso, funciones beta o endpoints que deberían ser accesibles mediante una URL directa pero no descubribles a través de la navegación del sitio. +Puedes controlar qué operaciones de OpenAPI se publican como páginas de documentación y su visibilidad en la navegación. Esto es útil para endpoints internos, operaciones en desuso, funciones beta o endpoints que deberían ser accesibles mediante una URL directa pero no detectables a través de la navegación del sitio. -Si tus páginas se generan automáticamente a partir de un documento de OpenAPI, puedes gestionar su visibilidad con las extensiones `x-hidden` y `x-excluded`. +Si tus páginas se generan automáticamente a partir de un documento de OpenAPI, puedes gestionar la visibilidad de las páginas con las extensiones `x-hidden` y `x-excluded`. @@ -13,11 +13,11 @@ Si tus páginas se generan automáticamente a partir de un documento de OpenAPI, ## `x-hidden` -La extensión `x-hidden` crea una página para un endpoint, pero la oculta de la navigation. La página solo se puede acceder navegando directamente a su URL. +La extensión `x-hidden` crea una página para un endpoint, pero la oculta de la navigation. La página solo es accesible si se navega directamente a su URL. -Los casos de uso comunes de `x-hidden` son: +Algunos casos de uso comunes de `x-hidden` son: -- Endpoints que quieres documentar, pero no promocionar. +- Endpoints que deseas documentar, pero no destacar. - Páginas a las que enlazarás desde otro contenido. - Endpoints para usuarios específicos. @@ -29,11 +29,11 @@ Los casos de uso comunes de `x-hidden` son: La extensión `x-excluded` excluye por completo un endpoint de tu documentación. -Los casos de uso habituales de `x-excluded` son: +Los casos de uso comunes de `x-excluded` son: -- Endpoints internos. +- Endpoints internos únicamente. - Endpoints en desuso que no quieres documentar. -- Funcionalidades en beta que aún no están listas para la documentación pública. +- Funcionalidades beta que aún no están listas para la documentación pública. @@ -41,9 +41,9 @@ Los casos de uso habituales de `x-excluded` son: ## Implementación -Agrega la extensión `x-hidden` o `x-excluded` debajo del método HTTP en tu especificación de OpenAPI. +Añade la extensión `x-hidden` o `x-excluded` bajo el método HTTP en tu especificación de OpenAPI. -A continuación, se muestran ejemplos de cómo usar cada propiedad en un documento de esquema de OpenAPI para un endpoint y una ruta de webhook. +Aquí tienes ejemplos de cómo usar cada propiedad en un documento de esquema de OpenAPI para un endpoint y una ruta de webhook. ```json {11, 19} "paths": { diff --git a/es/api-playground/customization/multiple-responses.mdx b/es/api-playground/customization/multiple-responses.mdx index b222078ce..84f555ebf 100644 --- a/es/api-playground/customization/multiple-responses.mdx +++ b/es/api-playground/customization/multiple-responses.mdx @@ -1,9 +1,9 @@ --- -title: "Respuestas múltiples" -description: "Muestra variaciones de respuesta para el mismo endpoint" +title: "Multiple responses" +description: "Mostrar variaciones de respuesta para el mismo endpoint" --- -Si tu API devuelve diferentes respuestas según los parámetros de entrada, el contexto del usuario u otras condiciones de la solicitud, puedes documentar varios ejemplos de respuesta con la propiedad `examples`. +Si tu API devuelve respuestas diferentes según los parámetros de entrada, el contexto del usuario u otras condiciones de la solicitud, puedes documentar varios ejemplos de respuesta con la propiedad `examples`. Esta propiedad se puede añadir a cualquier respuesta y tiene el siguiente esquema. diff --git a/es/api-playground/mdx/authentication.mdx b/es/api-playground/mdx/authentication.mdx index 97bce82e0..54d8e23ce 100644 --- a/es/api-playground/mdx/authentication.mdx +++ b/es/api-playground/mdx/authentication.mdx @@ -1,6 +1,6 @@ --- title: "Autenticación" -description: "Puedes configurar parámetros de autenticación para que los usuarios utilicen sus propias API keys reales." +description: "Puedes configurar parámetros de autenticación para permitir que los usuarios usen sus keys de API reales." --- @@ -9,9 +9,9 @@ description: "Puedes configurar parámetros de autenticación para que los usuar ## Habilitar la autenticación -Puedes añadir un método de autenticación en tu `docs.json` para habilitarla globalmente en todas las páginas, o configurarlo de forma individual por página. +Puedes añadir un método de autenticación en tu `docs.json` para habilitarla globalmente en todas las páginas o configurarla de forma individual por página. -Si se definen ambos, el método de autenticación de una página reemplazará al método global. +El método de autenticación definido en una página reemplazará al global si ambos están establecidos.
### Token Bearer @@ -93,7 +93,7 @@ authMethod: "key" ### Ninguno
-El método de autenticación "none" es útil para desactivar la autenticación en un endpoint específico después de definir un valor predeterminado en docs.json. +El método de autenticación "none" es útil para deshabilitar la autenticación en un endpoint específico después de establecer un valor predeterminado en docs.json. ```mdx Page Metadata diff --git a/es/api-playground/mdx/configuration.mdx b/es/api-playground/mdx/configuration.mdx index 1317d6052..4148cca17 100644 --- a/es/api-playground/mdx/configuration.mdx +++ b/es/api-playground/mdx/configuration.mdx @@ -3,13 +3,13 @@ title: 'Configuración de MDX' description: 'Genera páginas de documentación para tus endpoints de API usando `MDX`' --- -Puedes definir manualmente endpoints de API en archivos `MDX` individuales en lugar de usar una especificación OpenAPI. Este método ofrece flexibilidad para contenido personalizado, pero recomendamos generar la documentación de la API a partir de un archivo de especificación OpenAPI para la mayoría de los proyectos, ya que es más mantenible y completo. Aun así, crear páginas `MDX` para una API puede ser útil para documentar APIs pequeñas o para crear prototipos. +Puedes definir manualmente endpoints de API en archivos `MDX` individuales en lugar de usar una especificación OpenAPI. Este método ofrece flexibilidad para contenido personalizado, pero recomendamos generar la documentación de la API a partir de un archivo de especificación OpenAPI para la mayoría de los proyectos, ya que es más fácil de mantener y más completo en funcionalidades. Aun así, crear páginas `MDX` para una API puede ser útil para documentar APIs pequeñas o para hacer prototipos. -Para generar páginas para endpoints de API usando `MDX`, configura tu API en `docs.json`, crea archivos `MDX` individuales para cada endpoint y utiliza componentes como `` para definir parámetros. A partir de estas definiciones, Mintlify genera áreas de pruebas de la API interactivas, ejemplos de solicitudes y ejemplos de respuestas. +Para generar páginas para endpoints de API usando `MDX`, configura tu API en `docs.json`, crea archivos `MDX` individuales para cada endpoint y usa componentes como `` para definir parámetros. A partir de estas definiciones, Mintlify genera áreas de pruebas de la API interactivas, ejemplos de solicitudes y ejemplos de respuestas. - En tu archivo `docs.json`, define la URL base y el método de autenticación: + En tu archivo `docs.json`, define tu URL base y el método de autenticación: ```json "api": { @@ -23,7 +23,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d } ``` - Si deseas ocultar el área de pruebas de la API, utiliza el campo `display`. No necesitas incluir un método de autenticación si ocultas el área de pruebas. + Si deseas ocultar el área de pruebas de la API, usa el campo `display`. No necesitas incluir un método de autenticación si ocultas el área de pruebas. ```json "api": { @@ -33,11 +33,11 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d } ``` - Encuentra la lista completa de configuraciones de la API en [Settings](/es/settings#api-configurations). + Consulta la lista completa de configuraciones de la API en [Settings](/es/settings#api-configurations). - Cada página de endpoint de API debe tener un archivo `MDX` correspondiente. En la parte superior de cada archivo, define `title` y `api`: + Cada endpoint de la API debe tener un archivo `MDX` correspondiente. En la parte superior de cada archivo, define `title` y `api`: ```mdx --- @@ -46,7 +46,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d --- ``` - Puedes especificar parámetros de ruta agregando el nombre del parámetro a la ruta, entre `{}`: + Puedes especificar parámetros de ruta agregando el nombre del parámetro en la ruta, entre `{}`: ```bash https://api.example.com/v1/endpoint/{userId} @@ -56,7 +56,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d Si tienes un campo `server` configurado en `docs.json`, puedes usar rutas relativas como `/v1/endpoint`. - Puedes sobrescribir el modo de visualización definido globalmente para el área de pruebas de la API en una página agregando `playground` al frontmatter: + Puedes sustituir el modo de visualización definido globalmente para el área de pruebas de la API en una página agregando `playground` al frontmatter: ```mdx --- @@ -67,12 +67,12 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d ``` * `playground: 'interactive'` - Muestra el área de pruebas interactiva. - * `playground: 'simple'` - Muestra un endpoint que se puede copiar, sin área de pruebas. + * `playground: 'simple'` - Muestra un endpoint copiable sin área de pruebas. * `playground: 'none'` - Oculta el área de pruebas. - Agrega las páginas de tus endpoints a la barra lateral añadiendo las rutas al campo `navigation` en tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/navigation). + Agrega las páginas de tus endpoints a la barra lateral añadiendo las rutas en el campo `navigation` de tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/navigation). @@ -80,12 +80,12 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d ## Habilitar la autenticación -Puedes añadir un método de autenticación en tu `docs.json` para habilitarla globalmente en todas las páginas, o configurarla de forma individual por página. +Puedes añadir un método de autenticación en tu `docs.json` para habilitarla globalmente en todas las páginas, o configurarlo de forma individual por página. -El método de autenticación definido en una página tendrá prioridad sobre el global si ambos están configurados. +El método de autenticación definido en una página reemplazará el método global si ambos están configurados.
- ### Token bearer + ### Token de portador (Bearer)
@@ -158,7 +158,7 @@ El método de autenticación definido en una página tendrá prioridad sobre el ### Ninguno -El método de autenticación `none` es útil para desactivar la autenticación en un endpoint específico después de definir un valor predeterminado en docs.json. +El método de autenticación `none` es útil para desactivar la autenticación en un endpoint específico después de establecer un valor predeterminado en docs.json. ```mdx Page Metadata diff --git a/es/api-playground/migrating-from-mdx.mdx b/es/api-playground/migrating-from-mdx.mdx index 90542ffd6..c89b5d4c9 100644 --- a/es/api-playground/migrating-from-mdx.mdx +++ b/es/api-playground/migrating-from-mdx.mdx @@ -1,25 +1,25 @@ --- -title: "Migrar páginas de API en MDX a la navigation de OpenAPI" +title: "Migración de páginas de API en MDX a navigation de OpenAPI" sidebarTitle: "Migración desde MDX" -description: "Actualiza páginas individuales de endpoints en MDX a la generación automatizada con OpenAPI y una navigation flexible" +description: "Actualiza de páginas individuales de endpoints en MDX a una generación automatizada con OpenAPI y navigation flexible" icon: "arrow-big-right-dash" --- -Si actualmente utilizas páginas individuales en `MDX` para los endpoints de tu API, puedes migrar a la generación automática de páginas a partir de tu especificación de OpenAPI, manteniendo la personalización de las páginas individuales. Esto puede ayudarte a reducir la cantidad de archivos que debes mantener y a mejorar la coherencia de la documentación de tu API. +Si actualmente usas páginas individuales en `MDX` para los endpoints de tu API, puedes migrar a la generación automática de páginas a partir de tu especificación de OpenAPI, conservando la personalización de las páginas individuales. Esto puede ayudarte a reducir la cantidad de archivos que debes mantener y a mejorar la coherencia de tu documentación de API. -Puedes definir metadata y contenido para cada endpoint en tu especificación de OpenAPI y organizar los endpoints donde quieras dentro de tu navigation. +Puedes definir metadata y contenido para cada endpoint en tu especificación de OpenAPI y organizar los endpoints donde quieras en tu navigation.
## Migración con la CLI
-El comando `mint migrate-mdx` es la forma recomendada de migrar de páginas de endpoints en MDX a páginas autogeneradas. +El comando `mint migrate-mdx` es la forma recomendada de migrar de páginas de endpoint en MDX a páginas autogeneradas. Este comando: * Analiza la estructura de navigation en `docs.json`. * Identifica las páginas MDX que generan páginas de endpoints de OpenAPI. -* Extrae el contenido de los archivos MDX y lo mueve a la extensión `x-mint` en tu especificación de OpenAPI. +* Extrae el contenido de archivos MDX y lo mueve a la extensión `x-mint` en tu especificación de OpenAPI. * Actualiza tu `docs.json` para referenciar directamente los endpoints de OpenAPI en lugar de archivos MDX. * Elimina los archivos MDX originales de endpoints. @@ -28,17 +28,17 @@ Este comando: Si tienes varias páginas MDX para el mismo endpoint con contenido diferente, el script usará el contenido de la página que aparezca de última en tu `docs.json`. - La herramienta de migración no permite previsualizar los cambios antes de aplicarlos. + La herramienta de migración no admite la vista previa de los cambios antes de aplicarlos. Asegúrate de que tu especificación de OpenAPI sea válida e incluya todos los endpoints que deseas documentar. - Cualquier página MDX que desees migrar debe tener el frontmatter `openapi:` que haga referencia a un endpoint. + Cualquier página MDX que quieras migrar debe tener el frontmatter `openapi:` que haga referencia a un endpoint. - Valida tu archivo OpenAPI usando el [Swagger Editor](https://editor.swagger.io/) o la [Mint CLI](https://www.npmjs.com/package/mint). + Valida tu archivo de OpenAPI usando el [Swagger Editor](https://editor.swagger.io/) o la [Mint CLI](https://www.npmjs.com/package/mint). @@ -61,12 +61,12 @@ Este comando: Asegúrate de que tu especificación de OpenAPI sea válida e incluya todos los endpoints que quieres documentar. - Para cualquier endpoint cuyo metadata o contenido quieras personalizar, agrega la extensión `x-mint` al endpoint. Consulta [extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) para más detalles. + Para los endpoints cuyo metadata o contenido quieras personalizar, agrega la extensión `x-mint` al endpoint. Consulta [x-mint extension](/es/api-playground/openapi-setup#x-mint-extension) para más detalles. - Para cualquier endpoint que quieras excluir de tu documentación, agrega la extensión `x-hidden` al endpoint. + Para los endpoints que quieras excluir de tu documentación, agrega la extensión `x-hidden` al endpoint. - Valida tu archivo de OpenAPI con el [Swagger Editor](https://editor.swagger.io/) o la [CLI de Mint](https://www.npmjs.com/package/mint). + Valida tu archivo de OpenAPI con el [Swagger Editor](https://editor.swagger.io/) o la [Mint CLI](https://www.npmjs.com/package/mint). @@ -96,18 +96,18 @@ Este comando:
- Después de verificar que tu nueva navegación funciona correctamente, elimina los archivos de endpoints `MDX` que ya no necesites. + Después de verificar que tu nueva navegación funciona correctamente, elimina los archivos de endpoint en `MDX` que ya no necesites.
Puedes personalizar cómo aparece la documentación de tu API en tu navigation.
- ### Navegación de contenido mixto + ### navigation con contenido mixto
Combina páginas de API generadas automáticamente con otras páginas: @@ -156,7 +156,7 @@ Organiza distintas versiones de la API usando pestañas o groups: Considera mantener páginas individuales de `MDX` cuando necesites: -* Contenido personalizado extenso por endpoint, como componentes de React o ejemplos largos. +* Contenido personalizado amplio por endpoint, como componentes de React o ejemplos extensos. * Diseños de página únicos. * Enfoques de documentación experimentales para endpoints específicos. diff --git a/es/api-playground/openapi-setup.mdx b/es/api-playground/openapi-setup.mdx index 70168c3f1..a35d487f3 100644 --- a/es/api-playground/openapi-setup.mdx +++ b/es/api-playground/openapi-setup.mdx @@ -1,6 +1,6 @@ --- title: "Configuración de OpenAPI" -description: "Hace referencia a endpoints de OpenAPI en tus páginas de documentación" +description: "Referencia endpoints de OpenAPI en tus páginas de documentación" icon: "file-json" --- @@ -10,25 +10,25 @@ OpenAPI es una especificación para describir APIs. Mintlify es compatible con d ## Añade un archivo de especificación OpenAPI -Para documentar tus endpoints con OpenAPI, necesitas un documento OpenAPI válido en formato JSON o YAML que cumpla la [especificación OpenAPI 3.0+](https://swagger.io/specification/). +Para documentar tus endpoints con OpenAPI, necesitas un documento OpenAPI válido en formato JSON o YAML que siga la [especificación OpenAPI 3.0+](https://swagger.io/specification/). Puedes crear páginas de API a partir de uno o varios documentos OpenAPI.
- ### Cómo describir tu API + ### Describir tu API
Recomendamos los siguientes recursos para aprender y elaborar tus documentos OpenAPI. * [Guía de OpenAPI de Swagger](https://swagger.io/docs/specification/v3_0/basic-structure/) para aprender la sintaxis de OpenAPI. -* [Fuentes en Markdown de la especificación OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/) para consultar los detalles de la especificación OpenAPI más reciente. +* [Fuentes Markdown de la especificación OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/) para consultar detalles de la especificación OpenAPI más reciente. * [Swagger Editor](https://editor.swagger.io/) para editar, validar y depurar tu documento OpenAPI. -* [La Mint CLI](https://www.npmjs.com/package/mint) para validar tu documento OpenAPI con el comando: `mint openapi-check `. +* [Mint CLI](https://www.npmjs.com/package/mint) para validar tu documento OpenAPI con el comando: `mint openapi-check `. - La Guía de OpenAPI de Swagger es para OpenAPI v3.0, pero casi toda la información + La Guía de OpenAPI de Swagger corresponde a OpenAPI v3.0, pero casi toda la información es aplicable a v3.1. Para obtener más información sobre las diferencias entre v3.0 - y v3.1, consulta [Migración de OpenAPI 3.0 a + y v3.1, consulta [Migrating from OpenAPI 3.0 to 3.1.0](https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0) en el blog de OpenAPI. @@ -37,7 +37,7 @@ Recomendamos los siguientes recursos para aprender y elaborar tus documentos Ope ### Especificar la URL de tu API -Para habilitar funciones de Mintlify como el área de pruebas de la API, agrega un campo `servers` a tu documento OpenAPI con la URL base de tu API. +Para habilitar funciones de Mintlify como el área de pruebas de la API, añade un campo `servers` a tu documento OpenAPI con la URL base de tu API. ```json { @@ -49,23 +49,23 @@ Para habilitar funciones de Mintlify como el área de pruebas de la API, agrega } ``` -En un documento de OpenAPI, los distintos endpoints de la API se definen por sus rutas, como `/users/{id}` o simplemente `/`. La URL base indica dónde deben agregarse estas rutas. Para más información sobre cómo configurar el campo `servers`, consulta [API Server and Base Path](https://swagger.io/docs/specification/api-host-and-base-path/) en la documentación de OpenAPI. +En un documento OpenAPI, los distintos endpoints de la API se especifican por sus rutas, como `/users/{id}` o simplemente `/`. La URL base define dónde se deben anexar estas rutas. Para obtener más información sobre cómo configurar el campo `servers`, consulta [API Server and Base Path](https://swagger.io/docs/specification/api-host-and-base-path/) en la documentación de OpenAPI. -El área de pruebas de la API utiliza estas URL de servidor para determinar adónde enviar las solicitudes. Si especificas varios servidores, un menú desplegable permitirá a los usuarios alternar entre ellos. Si no especificas un servidor, el área de pruebas de la API usará el modo simple, ya que no puede enviar solicitudes sin una URL base. +El área de pruebas de la API usa estas URLs de servidor para determinar a dónde enviar las solicitudes. Si especificas varios servidores, un menú desplegable permitirá a los usuarios cambiar entre ellos. Si no especificas un servidor, el área de pruebas de la API usará el modo simple, ya que no puede enviar solicitudes sin una URL base. -Si tu API tiene endpoints que existen en distintas URL, puedes [sobrescribir el campo de servidor](https://swagger.io/docs/specification/v3_0/api-host-and-base-path/#overriding-servers) para una ruta u operación determinada. +Si tu API tiene endpoints que existen en diferentes URLs, puedes [sobrescribir el campo de servidor](https://swagger.io/docs/specification/v3_0/api-host-and-base-path/#overriding-servers) para una ruta u operación específica.
### Especificar la autenticación
-Para habilitar la autenticación en tu documentación y en el área de pruebas de la API, configura los campos `securitySchemes` y `security` en tu documento de OpenAPI. Las descripciones de la API y el área de pruebas añadirán campos de autenticación en función de la configuración de seguridad de tu documento de OpenAPI. +Para habilitar la autenticación en tu documentación y en el área de pruebas de la API, configura los campos `securitySchemes` y `security` en tu documento OpenAPI. Las descripciones de la API y el área de pruebas de la API añadirán campos de autenticación según las configuraciones de seguridad de tu documento OpenAPI. - + Añade un campo `securitySchemes` para definir cómo se autentican los usuarios. - Este ejemplo muestra una configuración para la autenticación Bearer. + Este ejemplo muestra una configuración para autenticación Bearer. ```json { @@ -81,8 +81,8 @@ Para habilitar la autenticación en tu documentación y en el área de pruebas d ``` - - Añade un campo `security` para exigir autenticación. + + Añade un campo `security` para requerir autenticación. ```json { @@ -96,27 +96,27 @@ Para habilitar la autenticación en tu documentación y en el área de pruebas d -Los tipos de autenticación más comunes incluyen: +Los tipos de autenticación comunes incluyen: * [API Keys](https://swagger.io/docs/specification/authentication/api-keys/): Para keys en encabezados, query o cookies. * [Bearer](https://swagger.io/docs/specification/authentication/bearer-authentication/): Para tokens JWT (JSON Web Token) u OAuth. -* [Basic](https://swagger.io/docs/specification/authentication/basic-authentication/): Para nombre de usuario y contraseña. +* [Basic](https://swagger.io/docs/specification/authentication/basic-authentication/): Para usuario y contraseña. -Si distintos endpoints de tu API requieren diferentes métodos de autenticación, puedes [sobrescribir el campo de seguridad](https://swagger.io/docs/specification/authentication/#:~:text=you%20can%20apply%20them%20to%20the%20whole%20API%20or%20individual%20operations%20by%20adding%20the%20security%20section%20on%20the%20root%20level%20or%20operation%20level%2C%20respectively.) para una operación determinada. +Si distintos endpoints de tu API requieren métodos de autenticación diferentes, puedes [sobrescribir el campo de seguridad](https://swagger.io/docs/specification/authentication/#:~:text=you%20can%20apply%20them%20to%20the%20whole%20API%20or%20individual%20operations%20by%20adding%20the%20security%20section%20on%20the%20root%20level%20or%20operation%20level%2C%20respectively.) para una operación determinada. -Para más información sobre cómo definir y aplicar la autenticación, consulta [Authentication](https://swagger.io/docs/specification/authentication/) en la documentación de OpenAPI. +Para obtener más información sobre cómo definir y aplicar la autenticación, consulta [Authentication](https://swagger.io/docs/specification/authentication/) en la documentación de OpenAPI.
## Extensión `x-mint`
-La extensión `x-mint` es una extensión personalizada de OpenAPI que ofrece un control adicional sobre cómo se genera y se muestra la documentación de tu API. +La extensión `x-mint` es una extensión personalizada de OpenAPI que ofrece control adicional sobre cómo se genera y se muestra la documentación de tu API.
### Metadata
-Sobrescribe la metadata predeterminada de las páginas de API generadas añadiendo `x-mint: metadata` a cualquier operación. Puedes usar cualquier campo de metadata válido en el frontmatter de `MDX`, excepto `openapi`: +Anula la metadata predeterminada para las páginas de API generadas añadiendo `x-mint: metadata` a cualquier operación. Puedes usar cualquier campo de metadata que sea válido en el frontmatter de `MDX`, excepto `openapi`: ```json {7-13} { @@ -147,7 +147,7 @@ Sobrescribe la metadata predeterminada de las páginas de API generadas añadien ### Contenido -Agrega contenido antes de la documentación de la API generada automáticamente usando `x-mint: content`: +Añade contenido antes de la documentación de la API generada automáticamente usando `x-mint: content`: ```json {6-8} { @@ -175,7 +175,7 @@ La extensión `content` es compatible con todos los componentes y el formato MDX ### Href -Cambia la URL de la página del endpoint en tu documentación con `x-mint: href`: +Cambia la URL de la página del endpoint en tu documentación usando `x-mint: href`: ```json {6-8, 14-16} { @@ -206,14 +206,14 @@ Cuando `x-mint: href` está presente, la entrada de navegación enlaza directame ### MCP -Expón selectivamente endpoints como herramientas de Model Context Protocol (MCP) usando `x-mint: mcp`. Habilita solo los endpoints que sean seguros para el acceso público mediante herramientas de IA. +Expón selectivamente endpoints como herramientas de Model Context Protocol (MCP) usando `x-mint: mcp`. Habilita únicamente los endpoints que sean seguros para el acceso público a través de herramientas de IA. La configuración de MCP para el endpoint. - Indica si se expone el endpoint como herramienta MCP. Tiene prioridad sobre la configuración a nivel de archivo. + Indica si se expone el endpoint como una herramienta MCP. Tiene prioridad sobre la configuración a nivel de archivo. @@ -274,39 +274,39 @@ Expón selectivamente endpoints como herramientas de Model Context Protocol (MCP ``` -Para más información, consulta [Model Context Protocol](/es/ai/model-context-protocol). +Para obtener más información, consulta [Model Context Protocol](/es/ai/model-context-protocol).
- ## Rellenar automáticamente páginas de API + ## Rellenar automáticamente las páginas de la API
-Agrega un campo `openapi` a cualquier elemento de navigation en tu `docs.json` para generar automáticamente páginas de endpoints de OpenAPI. Puedes controlar dónde aparecen estas páginas en tu estructura de navegación, ya sea como secciones de API dedicadas o junto con otras páginas. +Agrega un campo `openapi` a cualquier elemento de navigation en tu `docs.json` para generar automáticamente páginas para endpoints de OpenAPI. Puedes controlar dónde aparecen estas páginas en tu estructura de navegación, ya sea como secciones de API dedicadas o junto con otras páginas. -El campo `openapi` acepta una ruta de archivo en tu repositorio de documentación o una URL a un documento de OpenAPI alojado. +El campo `openapi` acepta una ruta de archivo en tu repositorio de documentación o una URL a un documento de OpenAPI hospedado. Las páginas de endpoints generadas tienen estos valores de metadata predeterminados: * `title`: El campo `summary` de la operación, si está presente. Si no hay `summary`, el título se genera a partir del método HTTP y el endpoint. * `description`: El campo `description` de la operación, si está presente. -* `version`: El valor de `version` del ancla o Tab padre, si está presente. -* `deprecated`: El campo `deprecated` de la operación. Si es `true`, aparecerá una etiqueta de en desuso junto al título del endpoint en la navegación lateral y en la página del endpoint. +* `version`: El valor de `version` del ancla o Tab principal, si está presente. +* `deprecated`: El campo `deprecated` de la operación. Si es `true`, aparecerá una etiqueta en desuso junto al título del endpoint en la navegación lateral y en la página del endpoint. - Para excluir endpoints específicos de tus páginas de API generadas automáticamente, agrega la propiedad + Para excluir endpoints específicos de tus páginas de API generadas automáticamente, agrega la [x-hidden](/es/api-playground/customization/managing-page-visibility#x-hidden) - a la operación en tu especificación de OpenAPI. + property a la operación en tu especificación de OpenAPI. Hay dos enfoques para agregar páginas de endpoints a tu documentación: -1. **Secciones de API dedicadas**: Referencia especificaciones de OpenAPI en elementos de navegación para secciones de API dedicadas. -2. **Endpoints selectivos**: Referencia endpoints específicos en tu navegación junto con otras páginas. +1. **Secciones de API dedicadas**: Haz referencia a especificaciones de OpenAPI en elementos de navigation para secciones de API dedicadas. +2. **Endpoints selectivos**: Haz referencia a endpoints específicos en tu navigation junto con otras páginas.
### Secciones de API dedicadas
-Genera secciones de API dedicadas agregando un campo `openapi` a un elemento de navigation y ninguna otra página. Se incluirán todos los endpoints de la especificación: +Genera secciones de API dedicadas agregando un campo `openapi` a un elemento de navigation y sin otras páginas. Se incluirán todos los endpoints en la especificación: ```json {5} "navigation": { @@ -319,7 +319,7 @@ Genera secciones de API dedicadas agregando un campo `openapi` a un elemento de } ``` -Puedes usar varias especificaciones de OpenAPI en diferentes secciones de navegación: +Puedes utilizar varias especificaciones de OpenAPI en diferentes secciones de navigation: ```json {8-11, 15-18} "navigation": { @@ -348,7 +348,7 @@ Puedes usar varias especificaciones de OpenAPI en diferentes secciones de navega ``` - El campo `directory` es opcional y especifica dónde se almacenan las páginas de API generadas + El campo `directory` es opcional y especifica dónde se guardan las páginas de API generadas en tu repositorio de documentación. Si no se especifica, se usará por defecto el directorio `api-reference` de tu repositorio. @@ -357,7 +357,7 @@ Puedes usar varias especificaciones de OpenAPI en diferentes secciones de navega ### Endpoints selectivos -Cuando quieras tener más control sobre dónde aparecen los endpoints en tu documentación, puedes hacer referencia a endpoints específicos en tu navigation. Este enfoque te permite generar páginas de endpoints de la API junto con otros tipos de contenido. +Cuando quieras tener más control sobre dónde aparecen los endpoints en tu documentación, puedes hacer referencia a endpoints específicos en tu navigation. Este enfoque te permite generar páginas de endpoints de la API junto con otros contenidos.
#### Definir una especificación OpenAPI predeterminada @@ -389,13 +389,13 @@ Configura una especificación OpenAPI predeterminada para un elemento de navigat } ``` -Cualquier entrada de página que coincida con el formato `METHOD /path` generará una página de API para ese endpoint utilizando la especificación de OpenAPI predeterminada. +Cualquier entrada de página que coincida con el formato `METHOD /path` generará una página de API para ese endpoint usando la especificación de OpenAPI predeterminada.
#### Herencia de la especificación de OpenAPI
-Las especificaciones de OpenAPI se heredan en la jerarquía de navigation. Los elementos de navigation secundarios heredan la especificación de OpenAPI de su elemento principal, a menos que definan la suya propia: +Las especificaciones de OpenAPI se heredan a lo largo de la jerarquía de navigation. Los elementos de navigation secundarios heredan la especificación de OpenAPI de su elemento principal, a menos que definan la suya propia: ```json {3, 7-8, 11, 13-14} { @@ -435,15 +435,15 @@ Haz referencia a endpoints específicos sin establecer una especificación de Op } ``` -Este enfoque es útil cuando necesitas endpoints individuales de distintas especificaciones o cuando solo quieres incluir algunos endpoints. +Este enfoque es útil cuando necesitas endpoints individuales de distintas especificaciones o solo quieres incluir algunos endpoints seleccionados.
## Crear archivos `MDX` para páginas de la API
-Para tener control sobre páginas de endpoints individuales, crea páginas `MDX` para cada operación. Esto te permite personalizar los metadatos de la página, agregar contenido, omitir ciertas operaciones o reordenar páginas en tu navigation a nivel de página. +Para controlar páginas de endpoints individuales, crea páginas `MDX` para cada operación. Esto te permite personalizar la metadata de la página, agregar contenido, omitir ciertas operaciones o reordenar páginas en tu navigation a nivel de página. -Consulta un [ejemplo de página MDX OpenAPI de MindsDB](https://github.com/mindsdb/mindsdb/blob/main/docs/rest/databases/create-databases.mdx?plain=1) y cómo aparece en su [documentación en producción](https://docs.mindsdb.com/rest/databases/create-databases). +Consulta un [ejemplo de página MDX de OpenAPI de MindsDB](https://github.com/mindsdb/mindsdb/blob/main/docs/rest/databases/create-databases.mdx?plain=1) y cómo aparece en su [documentación en vivo](https://docs.mindsdb.com/rest/databases/create-databases).
### Especificar archivos manualmente @@ -453,28 +453,28 @@ Crea una página `MDX` para cada endpoint y especifica qué operación de OpenAP Cuando haces referencia a una operación de OpenAPI de esta manera, el nombre, la descripción, los parámetros, las respuestas y el área de pruebas de la API se generan automáticamente a partir de tu documento de OpenAPI. -Si tienes varios archivos de OpenAPI, incluye la ruta del archivo en tu referencia para asegurar que Mintlify encuentre el documento de OpenAPI correcto. Si solo tienes un archivo de OpenAPI, Mintlify lo detectará automáticamente. +Si tienes varios archivos de OpenAPI, incluye la ruta del archivo en tu referencia para asegurarte de que Mintlify encuentre el documento de OpenAPI correcto. Si solo tienes un archivo de OpenAPI, Mintlify lo detectará automáticamente. - Este enfoque funciona independientemente de si has establecido una especificación - OpenAPI predeterminada en tu navigation. Puedes hacer referencia a cualquier endpoint - de cualquier especificación OpenAPI incluyendo la ruta del archivo en el frontmatter. + Este enfoque funciona independientemente de si configuraste una especificación de OpenAPI + predeterminada en tu navigation. Puedes referenciar cualquier endpoint de cualquier + especificación de OpenAPI incluyendo la ruta del archivo en el frontmatter. -Si deseas hacer referencia a un archivo OpenAPI externo, agrega la URL del archivo a tu `docs.json`. +Si deseas referenciar un archivo de OpenAPI externo, agrega la URL del archivo a tu `docs.json`. - ```mdx Example + ```mdx Ejemplo --- title: "Get users" - description: "Devuelve todas las plantas del sistema a las que el usuario tiene acceso" + description: "Returns all plants from the system that the user has access to" openapi: "/path/to/openapi-1.json GET /users" deprecated: true version: "1.0" --- ``` - ```mdx Format + ```mdx Formato --- title: "title of the page" description: "description of the page" @@ -487,39 +487,39 @@ Si deseas hacer referencia a un archivo OpenAPI externo, agrega la URL del archi El método y la ruta deben coincidir exactamente con la definición en tu - especificación OpenAPI. Si el endpoint no existe en el archivo OpenAPI, - la página quedará vacía. + especificación de OpenAPI. Si el endpoint no existe en el archivo de OpenAPI, la página + quedará vacía.
- ### Generar automáticamente archivos `MDX` + ### Generar archivos `MDX` automáticamente
-Usa nuestro [scraper](https://www.npmjs.com/package/@mintlify/scraping) de Mintlify para generar automáticamente páginas `MDX` para documentos OpenAPI grandes. +Usa nuestro [scraper](https://www.npmjs.com/package/@mintlify/scraping) de Mintlify para generar automáticamente páginas `MDX` para documentos extensos de OpenAPI. - Tu documento OpenAPI debe ser válido o los archivos no se generarán automáticamente. + Tu documento de OpenAPI debe ser válido o los archivos no se generarán automáticamente. El scraper genera: -* Una página `MDX` por cada operación en el campo `paths` de tu documento OpenAPI. -* Si tu documento OpenAPI es versión 3.1+, una página `MDX` por cada operación en el campo `webhooks` de tu documento OpenAPI. +* Una página `MDX` por cada operación en el campo `paths` de tu documento de OpenAPI. +* Si tu documento de OpenAPI es versión 3.1+, una página `MDX` por cada operación en el campo `webhooks` de tu documento de OpenAPI. * Un arreglo de entradas de navigation que puedes agregar a tu `docs.json`. - + ```bash npx @mintlify/scraping@latest openapi-file ``` - + ```bash npx @mintlify/scraping@latest openapi-file -o api-reference ``` - Agrega el flag `-o` para especificar una carpeta donde guardar los archivos. Si no se especifica una carpeta, los archivos se guardarán en el directorio de trabajo. + Agrega la bandera `-o` para especificar una carpeta en la que generar los archivos. Si no se especifica una carpeta, los archivos se generarán en el directorio de trabajo. @@ -527,16 +527,16 @@ El scraper genera: ### Crear archivos `MDX` para esquemas de OpenAPI
-Puedes crear páginas individuales para cualquier esquema de OpenAPI definido en el campo `components.schema` de un documento OpenAPI: +Puedes crear páginas individuales para cualquier esquema de OpenAPI definido en el campo `components.schema` de un documento de OpenAPI: - ```mdx Example + ```mdx Ejemplo --- openapi-schema: OrderItem --- ``` - ```mdx Format + ```mdx Formato --- openapi-schema: "schema-key" --- @@ -547,7 +547,7 @@ Puedes crear páginas individuales para cualquier esquema de OpenAPI definido en ## Webhooks
-Los webhooks son callbacks HTTP que tu API envía para notificar a sistemas externos cuando se producen eventos. Los webhooks son compatibles en documentos OpenAPI 3.1+. +Los webhooks son callbacks HTTP que tu API envía para notificar a sistemas externos cuando se producen eventos. Los webhooks son compatibles en documentos de OpenAPI 3.1+.
### Define webhooks en tu especificación de OpenAPI @@ -572,5 +572,5 @@ openapi: "path/to/openapi-file webhook example-webhook-name" ``` - El nombre del webhook debe coincidir exactamente con la key definida en el campo `webhooks` de tu especificación OpenAPI. + El nombre del webhook debe coincidir exactamente con la key definida en el campo `webhooks` de tu especificación de OpenAPI. diff --git a/es/api-playground/overview.mdx b/es/api-playground/overview.mdx index 2982a33f7..c5d113d87 100644 --- a/es/api-playground/overview.mdx +++ b/es/api-playground/overview.mdx @@ -1,5 +1,5 @@ --- -title: "Zona de pruebas" +title: "Playground" description: "Permite que las personas interactúen con tu API" icon: "play" --- @@ -8,7 +8,7 @@ icon: "play" ## Descripción general
-El área de pruebas de la API es un entorno interactivo que permite a los usuarios probar y explorar los endpoints de tu API. Los desarrolladores pueden crear solicitudes a la API, enviarlas y ver las respuestas sin salir de tu documentación. +El área de pruebas de la API es un entorno interactivo que permite a los usuarios probar y explorar tus endpoints de API. Los desarrolladores pueden elaborar solicitudes a la API, enviarlas y ver las respuestas sin salir de tu documentación. Área de pruebas de la API para el endpoint que desencadena una actualización. @@ -18,16 +18,16 @@ El área de pruebas de la API es un entorno interactivo que permite a los usuari El área de pruebas se genera automáticamente a partir de tu especificación de OpenAPI o del esquema de AsyncAPI, por lo que cualquier actualización de tu API se refleja automáticamente en el área de pruebas. También puedes crear manualmente páginas de referencia de la API después de definir una URL base y un método de Autenticación en tu `docs.json`. -Recomendamos generar tu área de pruebas de la API a partir de una especificación de OpenAPI. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup) para obtener más información sobre cómo crear tu documento de OpenAPI. +Recomendamos generar tu área de pruebas de la API a partir de una especificación de OpenAPI. Consulta [OpenAPI Setup](/es/api-playground/openapi-setup) para obtener más información sobre cómo crear tu documento de OpenAPI.
## Primeros pasos
- + - Asegúrate de que tu archivo de especificación de OpenAPI sea válido usando el [Swagger Editor](https://editor.swagger.io/) o la [Mint CLI](https://www.npmjs.com/package/mint). + Asegúrate de que tu archivo de especificación de OpenAPI sea válido usando el [Swagger Editor](https://editor.swagger.io/) o la [CLI de Mint](https://www.npmjs.com/package/mint). ```bash {3} @@ -38,9 +38,9 @@ Recomendamos generar tu área de pruebas de la API a partir de una especificaci - Actualiza tu `docs.json` para hacer referencia a tu especificación de OpenAPI. Agrega una propiedad `openapi` a cualquier elemento de navigation para completar automáticamente tu documentación con páginas para cada endpoint especificado en tu documento de OpenAPI. + Actualiza tu `docs.json` para hacer referencia a tu especificación de OpenAPI. Agrega la propiedad `openapi` a cualquier elemento de navigation para autogenerar páginas en tu documentación para cada endpoint definido en tu documento de OpenAPI. - Este ejemplo genera una página para cada endpoint especificado en `openapi.json` y las organiza en el grupo "API reference" dentro de tu navigation. + Este ejemplo genera una página por cada endpoint definido en `openapi.json` y las organiza en el grupo "API reference" dentro de tu navigation. ```json "navigation": { @@ -53,9 +53,9 @@ Recomendamos generar tu área de pruebas de la API a partir de una especificaci } ``` - Para generar páginas solo para endpoints específicos, enumera los endpoints en la propiedad `pages` del elemento de navigation. + Para generar páginas solo para endpoints específicos, enuméralos en la propiedad `pages` del elemento de navigation. - Este ejemplo genera páginas solo para los endpoints `GET /users` y `POST /users`. Para generar páginas para otros endpoints, agrega los endpoints adicionales al arreglo `pages`. + Este ejemplo genera páginas únicamente para los endpoints `GET /users` y `POST /users`. Para generar páginas de otros endpoints, agrega más endpoints al arreglo `pages`. ```json "navigation": { @@ -75,17 +75,17 @@ Recomendamos generar tu área de pruebas de la API a partir de una especificaci
- ## Personalizar tu área de pruebas + ## Personalización del área de pruebas
Puedes personalizar tu área de pruebas de la API definiendo las siguientes propiedades en tu `docs.json`. - Configuración del área de pruebas de la API. + Configuraciones del área de pruebas de la API. - Modo de visualización del área de pruebas de la API. + El modo de visualización del área de pruebas de la API. * `"interactive"`: Muestra el área de pruebas interactiva. * `"simple"`: Muestra un endpoint que se puede copiar, sin área de pruebas. @@ -95,23 +95,23 @@ Puedes personalizar tu área de pruebas de la API definiendo las siguientes prop - Indica si las solicitudes de la API se enrutan a través de un servidor proxy. De forma predeterminada es `true`. + Indica si se deben enviar las solicitudes de la API a través de un servidor proxy. De manera predeterminada es `true`. - Configuración de los ejemplos de API generados automáticamente. + Configuraciones para los ejemplos de API generados automáticamente. - Idiomas de ejemplo para los fragmentos de API generados automáticamente. + Idiomas para los fragmentos de API generados automáticamente. Los idiomas se muestran en el orden especificado. - Indica si se muestran los parámetros opcionales en los ejemplos de la API. De forma predeterminada es `all`. + Indica si se deben mostrar los parámetros opcionales en los ejemplos de la API. De manera predeterminada es `all`. @@ -140,7 +140,7 @@ Este ejemplo configura el área de pruebas de la API para que sea interactiva, c ### Páginas de endpoints personalizadas -Cuando necesites mayor control sobre la documentación de tu API, utiliza la extensión `x-mint` en tu especificación de OpenAPI o crea páginas individuales en `MDX` para tus endpoints. +Cuando necesites más control sobre tu documentación de API, usa la extensión `x-mint` en tu especificación de OpenAPI o crea páginas `MDX` individuales para tus endpoints. Ambas opciones te permiten: @@ -148,11 +148,11 @@ Ambas opciones te permiten: * Añadir contenido adicional, como ejemplos * Controlar el comportamiento del playground por página -Se recomienda la extensión `x-mint` para que toda la documentación de tu API se genere automáticamente a partir de tu especificación de OpenAPI y se mantenga en un único archivo. +Se recomienda la extensión `x-mint` para que toda tu documentación de API se genere automáticamente a partir de tu especificación de OpenAPI y se mantenga en un solo archivo. -Se recomiendan las páginas individuales en `MDX` para APIs pequeñas o cuando quieras experimentar con cambios por página. +Se recomiendan las páginas `MDX` individuales para APIs pequeñas o cuando quieras probar cambios por página. -Para más información, consulta [extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) y [Configuración de MDX](/es/api-playground/mdx/configuration). +Para más información, consulta [Extensión x-mint](/es/api-playground/openapi-setup#x-mint-extension) y [Configuración de MDX](/es/api-playground/mdx/configuration).
## Lecturas adicionales diff --git a/es/api-playground/troubleshooting.mdx b/es/api-playground/troubleshooting.mdx index ffc938e6d..ec3aaf3e4 100644 --- a/es/api-playground/troubleshooting.mdx +++ b/es/api-playground/troubleshooting.mdx @@ -1,38 +1,40 @@ --- title: "Solución de problemas" -description: "Problemas comunes con las referencias de API" +description: "Problemas comunes con las referencias de la API" icon: "message-square-warning" --- -Si tus páginas de API no se muestran correctamente, revisa estos problemas de configuración comunes: +Si tus páginas de la API no se muestran correctamente, revisa estos problemas de configuración comunes: En este escenario, es probable que Mintlify no pueda encontrar tu documento de OpenAPI o que tu documento de OpenAPI sea inválido. - Ejecutar `mint dev` en local debería ayudarte a detectar algunos de estos problemas. + Ejecutar `mint dev` localmente debería revelar algunos de estos problemas. - Para verificar que tu documento de OpenAPI supere la validación: + Para verificar que tu documento de OpenAPI pasará la validación: 1. Visita [este validador](https://editor.swagger.io/) 2. Cambia a la pestaña "Validate text" 3. Pega tu documento de OpenAPI 4. Haz clic en "Validate it!" - Si el cuadro de texto que aparece debajo tiene un borde verde, tu documento ha pasado la validación. Este es exactamente el paquete de validación que utiliza Mintlify para validar documentos de OpenAPI, así que si tu documento pasa la validación aquí, es muy probable que el problema esté en otra parte. + Si el cuadro de texto que aparece abajo tiene un borde verde, tu documento ha pasado la validación. + Este es exactamente el paquete de validación que utiliza Mintlify para validar documentos de OpenAPI, así que si tu documento + pasa la validación aquí, hay muchas probabilidades de que el problema esté en otra parte. - Además, Mintlify no es compatible con OpenAPI 2.0. Si tu documento usa esa versión de la especificación, podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3): + Además, Mintlify no admite OpenAPI 2.0. Si tu documento usa esta versión de la especificación, + podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3): ![](/images/convert-oas-3.png) - - Esto suele deberse a un campo `openapi` mal escrito en la metadata de la página. Asegúrate de que - el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI. + + Esto suele deberse a que el campo `openapi` está mal escrito en la metadata de la página. Asegúrate de que el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI. - Aquí tienes un Ejemplo de cómo las cosas pueden salir mal: + Aquí tienes un ejemplo de cómo podrían salir mal las cosas: ```mdx get-user.mdx --- @@ -46,9 +48,9 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c get: ... ``` - Observa que la ruta en el campo `openapi` tiene una barra al final, mientras que la ruta en el documento de OpenAPI no la tiene. + Observa que la ruta en el campo `openapi` tiene una barra final, mientras que la ruta en el documento de OpenAPI no la tiene. - Otro problema común es un nombre de archivo mal escrito. Si especificas un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre del archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI, `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así: + Otro problema común es un nombre de archivo mal escrito. Si estás especificando un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre de archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI, `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así: ```mdx api-reference/v1/users/get-user.mdx --- @@ -58,15 +60,15 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c - Si tienes un domain personalizado configurado, esto podría deberse a tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`, todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`. + Si tienes un domain personalizado configurado, esto podría deberse a tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir solo solicitudes `GET`, entonces todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`. - Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en `docs.json`, como se describe en la [documentación de configuración](/es/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes vendrán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy. + Como alternativa, si tu proxy inverso te impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en el `docs.json`, como se describe en la [documentación de configuración](/es/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes llegarán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy. - Si estás usando una configuración de navigation de OpenAPI, pero las páginas no se están generando, revisa estos problemas comunes: + Si estás utilizando una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes: - 1. **Falta la especificación de OpenAPI predeterminada**: Asegúrate de tener un campo `openapi` configurado para el elemento de navigation: + 1. **Falta la especificación predeterminada de OpenAPI**: Asegúrate de tener un campo `openapi` establecido para el elemento de navigation: ```json {5} "navigation": { @@ -83,22 +85,22 @@ Si tus páginas de API no se muestran correctamente, revisa estos problemas de c } ``` - 2. **Herencia de la especificación OpenAPI**: Si usas navigation anidada, asegúrate de que los grupos hijos hereden la especificación OpenAPI correcta o definan la suya propia. + 2. **Herencia de la especificación OpenAPI**: Si usas navigation anidada, asegúrate de que los grupos secundarios hereden la especificación de OpenAPI correcta o definan la suya propia. - 3. **Problemas de validación**: Usa `mint openapi-check ` para comprobar que tu documento OpenAPI sea válido. + 3. **Problemas de validación**: Usa `mint openapi-check ` para verificar que tu documento de OpenAPI sea válido. - + 1. **Operaciones ocultas**: Las operaciones marcadas con `x-hidden: true` en tu especificación de OpenAPI no aparecerán en la navigation generada automáticamente. - 2. **Operaciones no válidas**: Es posible que se omitan las operaciones con errores de validación en la especificación de OpenAPI. Revisa tu documento de OpenAPI para detectar errores de sintaxis. - 3. **Inclusión manual vs. automática**: Si haces referencia a cualquier endpoint desde una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye las operaciones referenciadas en elementos de navigation secundarios. + 2. **Operaciones no válidas**: Las operaciones con errores de validación en la especificación de OpenAPI pueden omitirse. Revisa tu documento de OpenAPI para detectar errores de sintaxis. + 3. **Inclusión manual vs. automática**: Si haces referencia a endpoints desde una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye las operaciones referenciadas en elementos secundarios de la navigation. - Al combinar operaciones de OpenAPI con páginas de documentación estándar en navigation: + Al combinar operaciones de OpenAPI con páginas de documentación regulares en navigation: - 1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también "GET /users" en tu navigation. Si necesitas un archivo que comparta nombre con una operación, usa la extensión `x-mint` en el endpoint para que el href apunte a una ubicación diferente. + 1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también "GET /users" en tu navigation. Si necesitas tener un archivo que comparta nombre con una operación, usa la extensión `x-mint` para el endpoint para que el href apunte a una ubicación diferente. 2. **Resolución de rutas**: Las entradas de navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones previstas. - 3. **Sensibilidad a mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue entre mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation. + 3. **Diferenciación entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue entre mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation. \ No newline at end of file diff --git a/es/api-reference/assistant/create-assistant-message.mdx b/es/api-reference/assistant/create-assistant-message.mdx index fa0852437..ca8cff410 100644 --- a/es/api-reference/assistant/create-assistant-message.mdx +++ b/es/api-reference/assistant/create-assistant-message.mdx @@ -10,9 +10,9 @@ openapi: POST /assistant/{domain}/message La API del assistant tiene los siguientes límites: -- 10.000 usos por key al mes -- 10.000 solicitudes por organización de Mintlify por hora -- 10.000 solicitudes por IP al día +- 10,000 usos por key al mes +- 10,000 solicitudes por organización de Mintlify por hora +- 10,000 solicitudes por IP al día @@ -20,6 +20,6 @@ La API del assistant tiene los siguientes límites: ## Uso recomendado
-Para obtener mejores resultados, usa el [hook useChat de ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) para enviar solicitudes y manejar respuestas. +Para obtener mejores resultados, usa el [hook useChat de ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) para enviar solicitudes y gestionar respuestas. -Puedes configurar `fp`, `threadId` y `filter` en el campo `body` del parámetro de opciones que se pasa al hook. \ No newline at end of file +Puedes establecer `fp`, `threadId` y `filter` en el campo `body` del parámetro de opciones que se pasa al hook. \ No newline at end of file diff --git a/es/api-reference/introduction.mdx b/es/api-reference/introduction.mdx index 10a4c1259..42af73a7a 100644 --- a/es/api-reference/introduction.mdx +++ b/es/api-reference/introduction.mdx @@ -4,7 +4,7 @@ description: "Desencadenar actualizaciones, integrar el Asistente de IA y más" icon: "book-open" --- -La API REST de Mintlify te permite interactuar con tu documentación de forma programática, desencadenar actualizaciones e integrar experiencias de chat con tecnología de IA. +La API REST de Mintlify te permite interactuar programáticamente con tu documentación, desencadenar actualizaciones e integrar experiencias de chat con IA.
## Endpoints @@ -12,7 +12,7 @@ La API REST de Mintlify te permite interactuar con tu documentación de forma pr * [Activar actualización](/es/api-reference/update/trigger): Activa una actualización de tu sitio cuando lo desees. * [Obtener el estado de la actualización](/es/api-reference/update/status): Obtén el estado de una actualización y otros detalles sobre tu documentación. -* [Generar mensaje del assistant](/es/api-reference/assistant/create-assistant-message): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas. +* [Generar mensaje del assistant](/es/api-reference/assistant/create-assistant-message): Inserta el assistant, entrenado con tu documentación, en cualquier aplicación que elijas. * [Buscar en la documentación](/es/api-reference/assistant/search): Busca en tu documentación.
@@ -25,7 +25,7 @@ Puedes generar una API key desde el [dashboard](https://dashboard.mintlify.com/s ### Admin API key
-La admin API key se usa para los endpoints [Trigger update](/es/api-reference/update/trigger) y [Get update status](/es/api-reference/update/status). +La admin API key se utiliza para los endpoints [Trigger update](/es/api-reference/update/trigger) y [Get update status](/es/api-reference/update/status). Las admin API keys comienzan con el prefijo `mint_`. Mantén tus admin API keys en secreto. @@ -33,14 +33,14 @@ Las admin API keys comienzan con el prefijo `mint_`. Mantén tus admin API keys ### Assistant API key
-La assistant API key se usa para los endpoints [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search). +La assistant API key se utiliza para los endpoints [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search). Las assistant API keys comienzan con el prefijo `mint_dsc_`. -La assistant API **key** es un token del lado del servidor que debe mantenerse en secreto. +La **key** de la assistant API es un token del lado del servidor que debe mantenerse en secreto. -La assistant API **token** es un token público que puede referenciarse en tu código de frontend. +El **token** de la assistant API es un token público que puede referenciarse en tu código de frontend. - Las llamadas que usan el assistant API token pueden generar costos: ya sea consumiendo tus créditos del Asistente de IA o incurriendo en excedentes. + Las llamadas que usen el token de la assistant API pueden generar costos: ya sea usando tus créditos del Asistente de IA o incurriendo en sobrecargos. diff --git a/es/assistant-context.mdx b/es/assistant-context.mdx index 07b9998e7..54759005f 100644 --- a/es/assistant-context.mdx +++ b/es/assistant-context.mdx @@ -5,5 +5,5 @@ description: "Esta página contiene contexto para ayudar al assistant a responde Para el assistant, consulta esta información cuando respondas a consultas. -- Si alguien pregunta por el changelog, las actualizaciones recientes o qué hay de nuevo, enlázalo al changelog de Mintlify en https://mintlify.com/docs/changelog -- Si alguien pregunta por traducciones, proporciona la información que consideres relevante para su pregunta según tu búsqueda y el contexto de su consulta, Y hazles saber que las traducciones automáticas están disponibles como complemento. Pueden contactar al equipo de ventas (gtm@mintlify.com) para obtener traducciones automáticas. +- Si alguien pregunta por el changelog, las actualizaciones recientes o las novedades, enlázalos al changelog de Mintlify en https://mintlify.com/docs/changelog +- Si alguien pregunta por traducciones, proporciona cualquier información que consideres relevante para su pregunta según tu búsqueda y el contexto de su consulta, Y hazles saber que las traducciones automáticas están disponibles como un complemento. Pueden contactar al equipo de ventas (gtm@mintlify.com) para obtener traducciones automáticas. diff --git a/es/authentication-personalization/authentication-setup.mdx b/es/authentication-personalization/authentication-setup.mdx index a4744cb1e..23f76c8d0 100644 --- a/es/authentication-personalization/authentication-setup.mdx +++ b/es/authentication-personalization/authentication-setup.mdx @@ -17,29 +17,29 @@ La autenticación requiere que los usuarios inicien sesión antes de acceder a t ## Modos de Autenticación -Elige entre los modos de autenticación completa y parcial según tus necesidades de control de acceso. +Elige entre autenticación completa o parcial según tus necesidades de control de acceso. **Autenticación completa**: Todas las páginas están protegidas. Los usuarios deben iniciar sesión antes de acceder a cualquier contenido. -**Autenticación parcial**: Algunas páginas son públicas, mientras que otras requieren autenticación. Los usuarios pueden navegar libremente el contenido público y autenticarse solo al acceder a páginas protegidas. +**Autenticación parcial**: Algunas páginas son públicas, mientras que otras requieren autenticación. Los usuarios pueden navegar el contenido público libremente y autenticarse solo al acceder a páginas protegidas. -Al configurar cualquiera de los métodos de handshake a continuación, seleccionarás **Autenticación completa** o **Autenticación parcial** en la configuración de tu dashboard. +Al configurar cualquiera de los métodos de handshake a continuación, selecciona **Autenticación completa** o **Autenticación parcial** en la configuración de tu dashboard.
- ## Configuración de autenticación + ## Configuración de la autenticación
-Selecciona el método de negociación (handshake) que deseas configurar. +Selecciona el método de enlace (handshake) que deseas configurar. - La autenticación con contraseña proporciona únicamente control de acceso y **no** admite la personalización del contenido. + La autenticación con contraseña solo proporciona control de acceso y **no** admite la personalización de contenido. ### Requisitos previos - * Tus políticas de seguridad permiten compartir contraseñas entre usuarios. + * Tus requisitos de seguridad permiten compartir contraseñas entre usuarios. ### Implementación @@ -59,15 +59,15 @@ Selecciona el método de negociación (handshake) que deseas configurar. ## Ejemplo - Tu documentación está alojada en `docs.foo.com` y necesitas un control de acceso básico sin rastrear a usuarios individuales. Quieres evitar el acceso público manteniendo una configuración sencilla. + Tu documentación está alojada en `docs.foo.com` y necesitas un control de acceso básico sin rastrear a usuarios individuales. Quieres impedir el acceso público manteniendo una configuración sencilla. - **Crea una contraseña robusta** en tu dashboard. **Comparte las credenciales** con los usuarios autorizados. ¡Eso es todo! + **Crea una contraseña segura** en tu dashboard. **Comparte las credenciales** con los usuarios autorizados. ¡Listo! ### Requisitos previos - * Los usuarios de tu documentación también son sus editores. + * Tus usuarios de la documentación también son tus editores. ### Implementación @@ -92,7 +92,7 @@ Selecciona el método de negociación (handshake) que deseas configurar. **Habilita la autenticación de Mintlify** en la configuración de tu dashboard. - **Verifica el acceso del equipo** comprobando que todos los miembros del equipo estén añadidos a tu organización. + **Verifica el acceso del equipo** comprobando que todos los miembros estén agregados a tu organización. @@ -104,42 +104,42 @@ Selecciona el método de negociación (handshake) que deseas configurar. ### Implementación - - 1. En tu dashboard, ve a [Authentication](https://dashboard.mintlify.com/settings/deployment/authentication). - 2. Selecciona **Full Authentication** o **Partial Authentication**. + + 1. En tu dashboard, ve a [Autenticación](https://dashboard.mintlify.com/settings/deployment/authentication). + 2. Selecciona **Autenticación completa** o **Autenticación parcial**. 3. Selecciona **OAuth** y configura estos campos: * **Authorization URL**: Tu endpoint de OAuth. * **Client ID**: Tu identificador de cliente de OAuth 2.0. * **Client Secret**: Tu secreto de cliente de OAuth 2.0. - * **Scopes**: Permisos a solicitar. Copia la cadena de scopes **completa** (por ejemplo, para un scope como `provider.users.docs`, copia el `provider.users.docs` completo). Usa múltiples scopes si necesitas diferentes niveles de acceso. + * **Scopes**: Permisos a solicitar. Copia la cadena de scope **completa** (por ejemplo, para un scope como `provider.users.docs`, copia el `provider.users.docs` completo). Usa varios scopes si necesitas distintos niveles de acceso. * **Token URL**: Tu endpoint de intercambio de tokens de OAuth. - * **Info API URL** (opcional): Endpoint para recuperar la información del usuario para la personalización. Si se omite, el flujo de OAuth solo se usará para verificar la identidad y la información del usuario quedará vacía. + * **Info API URL** (opcional): Endpoint para obtener información del usuario para personalización. Si se omite, el flujo de OAuth solo se usará para verificar la identidad y la información del usuario estará vacía. * **Logout URL**: La URL de cierre de sesión nativa de tu proveedor de OAuth. Si tu proveedor tiene un parámetro `returnTo` o similar, haz que apunte de vuelta a la URL de tu documentación. 4. Selecciona **Guardar cambios**. - - 1. Copia la **Redirect URL** de tus [ajustes de Authentication](https://dashboard.mintlify.com/settings/deployment/authentication). - 2. Agrega la Redirect URL como una URL de redirección autorizada en tu servidor de OAuth. + + 1. Copia la **Redirect URL** desde tu [configuración de autenticación](https://dashboard.mintlify.com/settings/deployment/authentication). + 2. Agrega la redirect URL como una URL de redirección autorizada en tu servidor OAuth. - + Para habilitar funciones de personalización, crea un endpoint de API que: - * Acepte tokens de acceso de OAuth para la autenticación. - * Devuelva datos de usuario en el formato `User`. Consulta [User data format](/es/authentication-personalization/personalization-setup#user-data-format) para obtener más información. + * Acepte tokens de acceso de OAuth para autenticación. + * Devuelva datos de usuario en el formato `User`. Consulta [User data format](/es/authentication-personalization/personalization-setup#user-data-format) para más información. - Agrega la URL de este endpoint al campo **Info API URL** en tus [ajustes de Authentication](https://dashboard.mintlify.com/settings/deployment/authentication). + Agrega la URL de este endpoint al campo **Info API URL** en tu [configuración de autenticación](https://dashboard.mintlify.com/settings/deployment/authentication). ### Ejemplo - Tu documentación está alojada en `foo.com/docs` y tienes un servidor de OAuth existente en `auth.foo.com` que admite el Authorization Code Flow. + Tu documentación está alojada en `foo.com/docs` y tienes un servidor OAuth existente en `auth.foo.com` que admite el Authorization Code Flow. - **Configura los detalles de tu servidor de OAuth** en tu dashboard: + **Configura los detalles de tu servidor OAuth** en tu dashboard: * **Authorization URL**: `https://auth.foo.com/authorization` * **Client ID**: `ydybo4SD8PR73vzWWd6S0ObH` @@ -148,7 +148,7 @@ Selecciona el método de negociación (handshake) que deseas configurar. * **Info API URL**: `https://api.foo.com/docs/user-info` * **Logout URL**: `https://auth.foo.com/logout?returnTo=https%3A%2F%2Ffoo.com%2Fdocs` - **Crea un endpoint de información de usuario** en `api.foo.com/docs/user-info`, que requiera un token de acceso de OAuth con el scope `provider.users.docs` y devuelva: + **Crea un endpoint de información de usuario** en `api.foo.com/docs/user-info`, que requiera un token de acceso de OAuth con el scope `provider.users.docs` y que devuelva: ```json { @@ -160,13 +160,13 @@ Selecciona el método de negociación (handshake) que deseas configurar. } ``` - **Configura tu servidor OAuth para permitir redirecciones** a tu URL de callback. + **Configura tu servidor de OAuth para permitir redirecciones** a tu URL de callback. ### Requisitos previos - * Un sistema de autenticación que pueda generar y firmar JWT. + * Un sistema de autenticación que pueda generar y firmar JWT (JSON Web Token). * Un servicio de backend que pueda crear URL de redirección. ### Implementación @@ -177,28 +177,28 @@ Selecciona el método de negociación (handshake) que deseas configurar. 2. Selecciona **Autenticación completa** o **Autenticación parcial**. 3. Selecciona **JWT**. 4. Ingresa la URL de tu flujo de inicio de sesión existente y selecciona **Guardar cambios**. - 5. Selecciona **Generate new key**. - 6. Almacena tu key de forma segura donde tu backend pueda acceder a ella. + 5. Selecciona **Generar nueva clave**. + 6. Almacena tu clave de forma segura donde tu backend pueda acceder a ella.
Modifica tu flujo de inicio de sesión existente para incluir estos pasos después de autenticar al usuario: * Crea un JWT que contenga la información del usuario autenticado en el formato `User`. Consulta [Formato de datos de usuario](/es/authentication-personalization/personalization-setup#user-data-format) para más información. - * Firma el JWT con tu key secreta, usando el algoritmo EdDSA. + * Firma el JWT con tu clave secreta, usando el algoritmo EdDSA. * Crea una URL de redirección de vuelta a la ruta `/login/jwt-callback` de tu documentación, incluyendo el JWT como hash.
### Ejemplo - Tu documentación está alojada en `docs.foo.com` y cuentas con un sistema de autenticación existente en `foo.com`. Quieres extender tu flujo de inicio de sesión para otorgar acceso a la documentación mientras mantienes la documentación separada de tu dashboard (o no tienes un dashboard). + Tu documentación está alojada en `docs.foo.com` con un sistema de autenticación existente en `foo.com`. Quieres extender tu flujo de inicio de sesión para conceder acceso a la documentación mientras mantienes tu documentación separada de tu dashboard (o no tienes un dashboard). Crea un endpoint de inicio de sesión en `https://foo.com/docs-login` que extienda tu autenticación existente. Después de verificar las credenciales del usuario: - * Genera un JWT con los datos del usuario en el formato de Mintlify. + * Genera un JWT con datos del usuario en el formato de Mintlify. * Firma el JWT y redirige a `https://docs.foo.com/login/jwt-callback#{SIGNED_JWT}`. @@ -263,23 +263,23 @@ Selecciona el método de negociación (handshake) que deseas configurar. Cuando un usuario no autenticado intenta acceder a una página protegida, su destino previsto se conserva en la redirección a tu URL de inicio de sesión: 1. El usuario intenta visitar una página protegida: `https://docs.foo.com/quickstart`. - 2. Redirige a tu URL de inicio de sesión con un parámetro query de redirección: `https://foo.com/docs-login?redirect=%2Fquickstart`. + 2. Redirige a tu URL de inicio de sesión con un parámetro de query de redirección: `https://foo.com/docs-login?redirect=%2Fquickstart`. 3. Después de la autenticación, redirige a `https://docs.foo.com/login/jwt-callback?redirect=%2Fquickstart#{SIGNED_JWT}`. 4. El usuario llega a su destino original.
- ## Hacer páginas públicas + ## Hacer públicas las páginas
-Al usar autenticación parcial, todas las páginas están protegidas de forma predeterminada. Puedes hacer que páginas específicas sean visibles sin autenticación, ya sea a nivel de página o de grupo, con la propiedad `public`. +Cuando se utiliza la autenticación parcial, todas las páginas están protegidas de forma predeterminada. Puedes hacer que páginas específicas sean visibles sin autenticación, ya sea a nivel de página o de grupo, con la propiedad `public`.
- ### Nivel de página + ### A nivel de página
-Para hacer pública una página, agrega `public: true` al frontmatter de la página. +Para hacer que una página sea pública, agrega `public: true` al frontmatter de la página. ```mdx Public page example --- diff --git a/es/authentication-personalization/overview.mdx b/es/authentication-personalization/overview.mdx index 5838ff736..caa72821d 100644 --- a/es/authentication-personalization/overview.mdx +++ b/es/authentication-personalization/overview.mdx @@ -1,20 +1,20 @@ --- -title: "Descripción general" -description: "Controla quién ve tu documentación y personaliza su experiencia" +title: "Overview" +description: "Controla quién puede ver tu documentación y personaliza su experiencia" icon: "badge-info" keywords: ["auth"] --- - [Los planes Pro](https://mintlify.com/pricing?ref=authentication) incluyen autenticación con contraseña. + Los [planes Pro](https://mintlify.com/pricing?ref=authentication) incluyen autenticación con contraseña. - [Los planes Enterprise](https://mintlify.com/pricing?ref=authentication) incluyen todos los métodos de autenticación. + Los [planes Enterprise](https://mintlify.com/pricing?ref=authentication) incluyen todos los métodos de autenticación. Elige entre tres enfoques para gestionar el acceso y personalizar tu documentación según la información del usuario y tus necesidades de seguridad: -* **Autenticación completa**: Protección total de la privacidad para todo el contenido, con personalización completa. -* **Autenticación parcial**: Control de acceso página por página, con personalización completa. +* **Autenticación completa**: Privacidad total de todo el contenido con personalización completa. +* **Autenticación parcial**: Control de acceso por página con personalización completa. * **Personalización**: Personalización del contenido sin **garantías de seguridad**. Todo el contenido sigue siendo de acceso público.
@@ -23,51 +23,51 @@ Elige entre tres enfoques para gestionar el acceso y personalizar tu documentaci **Elige autenticación completa cuando:** -* Estás creando documentación interna de la empresa que contiene información sensible -* Documentas APIs propietarias que requieren verificación de usuario -* Creas guías de implementación específicas para clientes +* Crees documentación interna de la empresa que contenga información confidencial +* Documentes APIs propietarias que requieran verificación de usuarios +* Elabores guías de implementación específicas para clientes **Elige autenticación parcial cuando:** -* Ofreces guías públicas de introducción con funciones avanzadas privadas -* Publicas documentación de código abierto con secciones empresariales privadas +* Ofrezcas guías públicas de introducción con funciones avanzadas privadas +* Publiques documentación de código abierto con secciones empresariales privadas **Elige personalización cuando:** -* Creas documentación pública de API que muestre ejemplos específicos del usuario -* Creas sitios de marketing que personalicen el contenido según los perfiles de usuario -* Ofreces tutoriales públicos que se adapten a las preferencias o niveles de habilidad del usuario +* Crees documentación pública de API que muestre ejemplos específicos para cada usuario +* Crees sitios de marketing que personalicen el contenido según los perfiles de usuario +* Ofrezcas tutoriales públicos que se adapten a las preferencias o niveles de habilidad de los usuarios
- ## Métodos de enlace + ## Métodos de handshake
-Elige el método que mejor se ajuste a tu infraestructura y requisitos de seguridad. +Elige el método que mejor se adapte a tu infraestructura actual y a tus requisitos de seguridad. | Método | Disponible para | Complejidad de configuración | Ideal para | -|:-------|:--------------|:-----------------|:----------| +|:-------|:----------------|:-----------------------------|:-----------| | **JWT (JSON Web Token)** | Todos los enfoques | Media | Flujos de inicio de sesión personalizados, máximo control de seguridad | | **OAuth 2.0** | Todos los enfoques | Alta | Proveedores de autenticación de terceros, seguridad empresarial | -| **Dashboard de Mintlify** | Solo Autenticación | Baja | Equipos que ya usan el dashboard de Mintlify | +| **Mintlify Dashboard** | Solo Autenticación | Baja | Equipos que ya usan el dashboard de Mintlify | | **Contraseña** | Solo Autenticación | Baja | Acceso compartido simple sin personalización | -| **Sesión compartida** | Solo Personalización | Baja | Apps con autenticación basada en sesiones existente | +| **Sesión compartida** | Solo Personalización | Baja | Apps con autenticación basada en sesión existente |
### Cuándo usar cada método
-**JWT (JSON Web Token)**: Úsalo cuando ya tengas un sistema de Autenticación y quieras tener control total sobre el flujo de inicio de sesión. Ideal para una gestión de usuarios personalizada o cuando necesites desacoplar el acceso a la documentación de tu aplicación principal. +**JWT (JSON Web Token)**: Úsalo cuando ya tengas un sistema de autenticación y quieras tener control total del flujo de inicio de sesión. Ideal para la gestión personalizada de usuarios o cuando necesites desacoplar el acceso a la documentación de tu aplicación principal. -**OAuth 2.0**: Úsalo cuando quieras aprovechar proveedores de Autenticación de terceros (Google, GitHub, etc.) o necesites estándares de seguridad de nivel empresarial. Ideal para organizaciones que ya utilizan infraestructura de OAuth. +**OAuth 2.0**: Úsalo cuando quieras aprovechar proveedores de autenticación de terceros (Google, GitHub, etc.) o necesites estándares de seguridad de nivel empresarial. Lo mejor para organizaciones que ya usan infraestructura de OAuth. -**Dashboard de Mintlify**: Úsalo cuando quienes editan la documentación también son quienes la leen. Perfecto para equipos internos que ya gestionan contenido a través del dashboard de Mintlify. +**Dashboard de Mintlify**: Úsalo cuando quienes editan la documentación también sean quienes la consultan. Perfecto para equipos internos que ya gestionan contenido a través del dashboard de Mintlify. -**Contraseña**: Úsala para un control de acceso sencillo cuando no necesites rastrear usuarios individuales ni personalizar contenido. Adecuada para contratistas, usuarios beta o escenarios de acceso temporal. +**Contraseña**: Úsalo para un control de acceso sencillo cuando no necesites rastrear usuarios individuales ni personalizar el contenido. Adecuado para contratistas, usuarios beta o escenarios de acceso temporal. -**Sesión compartida**: Úsala cuando quieras un inicio de sesión fluido entre tu aplicación y la documentación. Ideal cuando los usuarios ya están autenticados en tu aplicación principal y quieres personalizar su experiencia en la documentación. +**Sesión compartida**: Úsalo cuando quieras un inicio de sesión sin fricciones entre tu aplicación y la documentación. Ideal cuando los usuarios ya están autenticados en tu aplicación principal y quieres personalizar su experiencia en la documentación.
## Personalización del contenido
-Los tres enfoques admiten funciones de personalización del contenido, como contenido MDX dinámico, prefilling de API key y controles de visibilidad de páginas. Para obtener orientación detallada sobre la implementación, consulta [Configuración de la personalización](/es/authentication-personalization/personalization-setup). \ No newline at end of file +Los tres enfoques admiten funciones de personalización del contenido, como contenido MDX dinámico, el rellenado previo de la API key y controles de visibilidad de páginas. Para obtener instrucciones de implementación detalladas, consulta [Configuración de personalización](/es/authentication-personalization/personalization-setup). \ No newline at end of file diff --git a/es/authentication-personalization/personalization-setup.mdx b/es/authentication-personalization/personalization-setup.mdx index 53b91a62a..77dcaba51 100644 --- a/es/authentication-personalization/personalization-setup.mdx +++ b/es/authentication-personalization/personalization-setup.mdx @@ -1,10 +1,10 @@ --- -title: "Configuración de la personalización" -description: "Permite que los usuarios inicien sesión para obtener experiencias de documentación personalizadas" +title: "Configuración de personalización" +description: "Permite que los usuarios inicien sesión para disfrutar de experiencias de documentación personalizadas" icon: "user-cog" --- -La personalización adapta tu documentación a cada usuario cuando ha iniciado sesión. Por ejemplo, puedes rellenar previamente sus API keys, mostrar contenido específico según su plan o rol, u ocultar secciones a las que no necesitan acceder. +La personalización adapta tu documentación a cada usuario cuando inicia sesión. Por ejemplo, puedes autocompletar sus API keys, mostrar contenido específico según su plan o rol, u ocultar secciones a las que no necesitan acceder. @@ -12,31 +12,31 @@ La personalización adapta tu documentación a cada usuario cuando ha iniciado s ## Funciones de personalización
-Personaliza el contenido con estas funciones de personalización. +Personaliza el contenido con estas capacidades de personalización.
- ### Autorrelleno de API key + ### Prefill de la key de la API
-Completa automáticamente los campos del área de pruebas de la API con valores específicos del usuario devolviendo nombres de campo que coincidan en tus datos de usuario. Los nombres de los campos en tus datos de usuario deben coincidir exactamente con los nombres del área de pruebas de la API para que el autorrelleno funcione. +Completa automáticamente los campos del área de pruebas de la API con valores específicos del usuario al devolver nombres de campo que coincidan en tus datos de usuario. Los nombres de campo en tus datos de usuario deben coincidir exactamente con los nombres del área de pruebas de la API para que el autocompletado funcione.
### Contenido MDX dinámico
-Muestra contenido dinámico según información del usuario como el nombre, el plan o la organización usando la variable `user`. +Muestra contenido dinámico en función de información del usuario como su nombre, plan u organización usando la variable `user`. ```jsx ¡Bienvenido de vuelta, {user.firstName}! Tu plan {user.org?.plan} incluye... ``` -Consulta la sección [Formato de datos de usuario](#user-data-format) a continuación para ver ejemplos detallados y orientación de implementación. +Consulte la sección [Formato de datos de usuario](#user-data-format) a continuación para ver ejemplos detallados y guía de implementación.
### Visibilidad de la página
-Restringe qué páginas son visibles para tus usuarios agregando campos `groups` al frontmatter de tus páginas. De forma predeterminada, todas las páginas son visibles para todos los usuarios. +Limite qué páginas son visibles para sus usuarios agregando campos `groups` al frontmatter de sus páginas. De forma predeterminada, todas las páginas son visibles para todos los usuarios. Los usuarios solo verán las páginas de los `groups` a los que pertenecen. @@ -53,7 +53,7 @@ groups: ["admin"] ## Formato de datos de usuario -Al implementar la personalización, tu sistema devuelve los datos del usuario en un formato específico que permite personalizar el contenido. Estos datos se pueden enviar como un objeto JSON en bruto o dentro de un JWT (JSON Web Token) firmado, según tu método de negociación. La estructura de los datos es la misma en ambos casos. +Al implementar la personalización, tu sistema devuelve los datos de usuario en un formato específico que permite personalizar el contenido. Estos datos pueden enviarse como un objeto JSON en bruto o dentro de un JWT (JSON Web Token) firmado, según tu método de handshake. La estructura de los datos es la misma en ambos casos. ```tsx type User = { @@ -71,7 +71,7 @@ type User = { Tiempo de expiración de la sesión en **segundos desde el epoch**. Si el usuario carga una página después de este tiempo, sus datos almacenados se eliminan automáticamente y deberá volver a autenticarse. - Para handshakes con JWT: Esto difiere del claim `exp` del JWT, que determina cuándo un JWT se considera inválido. Por seguridad, establece el claim `exp` del JWT con una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas). + Para handshakes con JWT: Esto difiere del claim `exp` del JWT, que determina cuándo un JWT se considera inválido. Por seguridad, establece el claim `exp` del JWT en una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas). @@ -81,7 +81,7 @@ type User = { - Datos personalizados accesibles en tu contenido `MDX` mediante la variable `user`. Úsalo para personalización dinámica en toda tu documentación. + Datos personalizados accesibles en tu contenido `MDX` a través de la variable `user`. Úsalo para personalización dinámica en toda tu documentación. **Ejemplo básico**: @@ -95,7 +95,7 @@ type User = { Welcome back, {user.firstName}! Your {user.plan} plan includes... ``` - Con los datos de `user` del ejemplo, esto se renderizaría como: Welcome back, Ronan! Your Enterprise plan includes... + Con los datos de `user` del ejemplo, se renderizaría como: Welcome back, Ronan! Your Enterprise plan includes... **Renderizado condicional avanzado**: @@ -110,12 +110,12 @@ type User = { ``` - La información en `user` solo está disponible para usuarios con sesión iniciada. Para usuarios que no hayan iniciado sesión, el valor de `user` será `{}`. Para evitar que la página falle con usuarios desconectados, utiliza siempre encadenamiento opcional en los campos de `user`. Por ejemplo, `{user.org?.plan}`. + La información en `user` solo está disponible para usuarios que han iniciado sesión. Para los usuarios que han cerrado sesión, el valor de `user` será `{}`. Para evitar que la página falle en usuarios que no han iniciado sesión, usa siempre el encadenamiento opcional en tus campos de `user`. Por ejemplo, `{user.org?.plan}`. - Valores específicos del usuario que precargan los campos del área de pruebas de la API. Ahorra tiempo a los usuarios al autocompletar sus datos cuando prueban APIs. + Valores específicos del usuario que rellenan previamente los campos del área de pruebas de la API. Ahorra tiempo al autocompletar sus datos cuando prueban APIs. **Ejemplo**: @@ -127,9 +127,9 @@ type User = { } ``` - Si un usuario realiza solicitudes en un subdominio específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se precargará en cualquier página de la API con el valor de `subdomain`. + Si un usuario realiza solicitudes en un subdominio específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se rellenará previamente en cualquier página de la API con el valor `subdomain`. - Los campos `header`, `query` y `cookie` solo se precargarán si forman parte de tu [OpenAPI security scheme](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se precargará. Crear un parámetro de encabezado estándar llamado `Authorization` no habilitará esta función. + Los campos `header`, `query` y `cookie` solo se rellenarán previamente si forman parte de tu [esquema de seguridad de OpenAPI](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se rellenará previamente. Crear un parámetro de cabecera estándar llamado `Authorization` no habilitará esta función.
@@ -162,10 +162,10 @@ type User = {
- ## Configurar la personalización + ## Configuración de la personalización
-Selecciona el método de handshake que quieres configurar. +Selecciona el método de autenticación que deseas configurar. @@ -179,20 +179,20 @@ Selecciona el método de handshake que quieres configurar. ### Implementación - + 1. En tu dashboard, ve a [Autenticación](https://dashboard.mintlify.com/settings/deployment/authentication). 2. Selecciona **Personalization**. 3. Selecciona **JWT**. 4. Ingresa la URL de tu flujo de inicio de sesión existente y selecciona **Guardar cambios**. 5. Selecciona **Generate new key**. - 6. Almacena tu key de forma segura donde pueda acceder tu backend. + 6. Almacena tu key de forma segura donde tu backend pueda acceder a ella. - + Modifica tu flujo de inicio de sesión existente para incluir estos pasos después de que el usuario inicie sesión: * Crea un JWT que contenga la información del usuario autenticado en el formato `User`. Consulta la sección [User data format](#user-data-format) más arriba para obtener más información. - * Firma el JWT con la clave secreta utilizando el algoritmo ES256. + * Firma el JWT con la key secreta, usando el algoritmo ES256. * Crea una URL de redirección de vuelta a tu documentación, incluyendo el JWT como hash. @@ -201,7 +201,7 @@ Selecciona el método de handshake que quieres configurar. Tu documentación está alojada en `docs.foo.com`. Quieres que tu documentación esté separada de tu dashboard (o no tienes un dashboard) y habilitar la personalización. - Genera un secreto JWT. Luego, crea un endpoint de inicio de sesión en `https://foo.com/docs-login` que inicie un flujo de inicio de sesión hacia tu documentación. + Genera un secreto JWT. Luego crea un endpoint de inicio de sesión en `https://foo.com/docs-login` que inicie un flujo de inicio de sesión hacia tu documentación. Después de verificar las credenciales del usuario: @@ -235,7 +235,7 @@ Selecciona el método de handshake que quieres configurar. } ``` - ### Conservar anclas de página + ### Conservación de anclas de página Para redirigir a los usuarios a secciones específicas después de iniciar sesión, usa este formato de URL: `https://docs.foo.com/page#jwt={SIGNED_JWT}&anchor={ANCHOR}`. @@ -248,7 +248,7 @@ Selecciona el método de handshake que quieres configurar. ### Requisitos previos - * Un servidor OAuth que admita el flujo Auth Code con PKCE + * Un servidor OAuth que sea compatible con el flujo Authorization Code con PKCE * Capacidad para crear un endpoint de API accesible mediante tokens de acceso de OAuth ### Implementación @@ -258,7 +258,7 @@ Selecciona el método de handshake que quieres configurar. Crea un endpoint de API que: * Acepte tokens de acceso de OAuth para la autenticación. - * Devuelva los datos del usuario en el formato `User`. Consulta la sección [User data format](#user-data-format) de arriba para más información. + * Devuelva datos de usuario en el formato `User`. Consulta la sección [User data format](#user-data-format) anterior para obtener más información. * Defina los scopes de acceso. @@ -269,16 +269,16 @@ Selecciona el método de handshake que quieres configurar. * **Authorization URL**: Tu endpoint de autorización de OAuth. * **Client ID**: Tu identificador de cliente de OAuth 2.0. - * **Scopes**: Permisos a solicitar. Copia la cadena de scopes **completa** (por ejemplo, para un scope como `provider.users.docs`, copia el `provider.users.docs` completo). Debe coincidir con los scopes del endpoint que configuraste en el primer paso. + * **Scopes**: Permisos a solicitar. Copia la cadena de scope **completa** (por ejemplo, para un scope como `provider.users.docs`, copia el `provider.users.docs` completo). Debe coincidir con los scopes del endpoint que configuraste en el primer paso. * **Token URL**: Tu endpoint de intercambio de tokens de OAuth. - * **Info API URL**: Endpoint para obtener los datos del usuario para la personalización. Creado en el primer paso. + * **Info API URL**: Endpoint para obtener datos de usuario para la personalización. Creado en el primer paso. 4. Selecciona **Guardar cambios** - 1. Copia la **Redirect URL** desde tu [authentication settings](https://dashboard.mintlify.com/settings/deployment/authentication). - 2. Agrega esta URL como una URL de redirección autorizada en la configuración de tu servidor OAuth. + 1. Copia la **Redirect URL** de tu [authentication settings](https://dashboard.mintlify.com/settings/deployment/authentication). + 2. Agrega esta URL como URL de redirección autorizada en la configuración de tu servidor OAuth. @@ -286,7 +286,7 @@ Selecciona el método de handshake que quieres configurar. Tu documentación está alojada en `foo.com/docs` y tienes un servidor OAuth existente que admite el flujo PKCE. Quieres personalizar tu documentación según los datos del usuario. - **Crea un endpoint de información del usuario** en `api.foo.com/docs/user-info`, que requiera un token de acceso de OAuth con el scope `provider.users.docs` y responda con los datos personalizados del usuario: + **Crea un endpoint de información de usuario** en `api.foo.com/docs/user-info`, que requiera un token de acceso de OAuth con el scope `provider.users.docs` y responda con los datos personalizados del usuario: ```json { @@ -306,19 +306,19 @@ Selecciona el método de handshake que quieres configurar. * **Token URL**: `https://auth.foo.com/exchange` * **Info API URL**: `https://api.foo.com/docs/user-info` - **Configura tu servidor OAuth** para permitir redireccionamientos a tu URL de callback. + **Configura tu servidor OAuth** para permitir redirecciones a tu URL de retorno. ### Requisitos previos * Un dashboard o portal de usuario con autenticación de sesión basada en cookies. - * Capacidad para crear un endpoint de API en el mismo origen o subdominio que tu dashboard. - * Si tu dashboard está en `foo.com`, la **URL de la API** debe comenzar con `foo.com` o `*.foo.com`. - * Si tu dashboard está en `dash.foo.com`, la **URL de la API** debe comenzar con `dash.foo.com` o `*.dash.foo.com`. - * Tus docs están alojados en el mismo dominio o subdominio que tu dashboard. - * Si tu dashboard está en `foo.com`, tus **docs** deben estar alojados en `foo.com` o `*.foo.com`. - * Si tu dashboard está en `*.foo.com`, tus **docs** deben estar alojados en `foo.com` o `*.foo.com`. + * Capacidad para crear un endpoint de API en el mismo origen o subdomain que tu dashboard. + * Si tu dashboard está en `foo.com`, la **API URL** debe comenzar con `foo.com` o `*.foo.com`. + * Si tu dashboard está en `dash.foo.com`, la **API URL** debe comenzar con `dash.foo.com` o `*.dash.foo.com`. + * Tu documentación está alojada en el mismo domain o subdomain que tu dashboard. + * Si tu dashboard está en `foo.com`, tu **documentación** debe estar alojada en `foo.com` o `*.foo.com`. + * Si tu dashboard está en `*.foo.com`, tu **documentación** debe estar alojada en `foo.com` o `*.foo.com`. ### Implementación @@ -327,10 +327,10 @@ Selecciona el método de handshake que quieres configurar. Crea un endpoint de API que: * Use tu autenticación de sesión existente para identificar a los usuarios - * Devuelva datos de usuario en el formato `User` (consulta la sección [User data format](#user-data-format) más arriba) - * Si el dominio de la API y el dominio de los docs **no coinciden exactamente**: + * Devuelva datos de usuario en el formato `User` (consulta la sección [Formato de datos de usuario](#user-data-format) anterior) + * Si el domain de la API y el domain de la documentación **no coinciden exactamente**: - * Agrega el dominio de los docs al encabezado `Access-Control-Allow-Origin` de tu API (no debe ser `*`). + * Agrega el domain de la documentación al encabezado `Access-Control-Allow-Origin` de tu API (no debe ser `*`). * Establece el encabezado `Access-Control-Allow-Credentials` de tu API en `true`. @@ -339,7 +339,7 @@ Selecciona el método de handshake que quieres configurar. - 1. En tu dashboard, ve a [Authentication](https://dashboard.mintlify.com/settings/deployment/authentication). + 1. En tu dashboard, ve a [Autenticación](https://dashboard.mintlify.com/settings/deployment/authentication). 2. Selecciona **Personalization**. 3. Selecciona **Shared Session**. 4. Ingresa tu **Info API URL**, que es el endpoint del primer paso. @@ -350,9 +350,9 @@ Selecciona el método de handshake que quieres configurar. ### Ejemplos - #### Dashboard en subdominio, docs en subdominio + #### Dashboard en subdomain, documentación en subdomain - Tienes un dashboard en `dash.foo.com`, que utiliza autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `dash.foo.com/api`. Quieres configurar la personalización para tus docs alojados en `docs.foo.com`. + Tienes un dashboard en `dash.foo.com`, que usa autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `dash.foo.com/api`. Quieres configurar la personalización para tu documentación alojada en `docs.foo.com`. **Proceso de configuración**: @@ -360,11 +360,11 @@ Selecciona el método de handshake que quieres configurar. 2. **Agrega encabezados CORS** solo para esta ruta: * `Access-Control-Allow-Origin`: `https://docs.foo.com` * `Access-Control-Allow-Credentials`: `true` - 3. **Configura la URL de la API** en la configuración de autenticación: `https://dash.foo.com/api/docs/user-info`. + 3. **Configura la API URL** en la configuración de autenticación: `https://dash.foo.com/api/docs/user-info`. - #### Dashboard en subdominio, docs en raíz + #### Dashboard en subdomain, documentación en raíz - Tienes un dashboard en `dash.foo.com`, que utiliza autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `dash.foo.com/api`. Quieres configurar la personalización para tus docs alojados en `foo.com/docs`. + Tienes un dashboard en `dash.foo.com`, que usa autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `dash.foo.com/api`. Quieres configurar la personalización para tu documentación alojada en `foo.com/docs`. **Proceso de configuración**: @@ -372,19 +372,19 @@ Selecciona el método de handshake que quieres configurar. 2. **Agrega encabezados CORS** solo para esta ruta: * `Access-Control-Allow-Origin`: `https://foo.com` * `Access-Control-Allow-Credentials`: `true` - 3. **Configura la URL de la API** en la configuración de autenticación: `https://dash.foo.com/api/docs/user-info`. + 3. **Configura la API URL** en la configuración de autenticación: `https://dash.foo.com/api/docs/user-info`. - #### Dashboard en raíz, docs en raíz + #### Dashboard en raíz, documentación en raíz - Tienes un dashboard en `foo.com/dashboard`, que utiliza autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `foo.com/api`. Quieres configurar la personalización para tus docs alojados en `foo.com/docs`. + Tienes un dashboard en `foo.com/dashboard`, que usa autenticación de sesión basada en cookies. Las rutas de tu API del dashboard están alojadas en `foo.com/api`. Quieres configurar la personalización para tu documentación alojada en `foo.com/docs`. **Proceso de configuración**: 1. **Crea el endpoint** `foo.com/api/docs/user-info` que identifique a los usuarios mediante autenticación de sesión y responda con sus datos de usuario. - 2. **Configura la URL de la API** en la configuración de autenticación: `https://foo.com/api/docs/user-info` + 2. **Configura la API URL** en la configuración de autenticación: `https://foo.com/api/docs/user-info` - No se necesita configuración de CORS ya que el dashboard y los docs comparten el mismo dominio. + No se necesita configuración de CORS ya que el dashboard y la documentación comparten el mismo domain. diff --git a/es/changelog.mdx b/es/changelog.mdx index 2463a27ba..5d4404f63 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -1,94 +1,94 @@ --- -title: "Actualizaciones de producto" -description: "Nuevos lanzamientos y mejoras" +title: "Actualizaciones del producto" +description: "Nuevas versiones y mejoras" rss: true noindex: true --- - + ## Mejoras en la integración con GitLab * Interfaz de conexión a GitLab mejorada en la configuración del dashboard para facilitar la gestión de repositorios - * Se añadió compatibilidad con webhooks para actualizar automáticamente la documentación con cada confirmación en GitLab + * Se añadió compatibilidad con webhooks para actualizaciones automáticas de la documentación al realizar confirmaciones en GitLab ## Mejoras en el editor web y la autenticación - * Continuamos la migración al enrutador de la app para el editor web, eliminando bloqueos y mejorando el rendimiento + * Continuación de la migración del app router para el editor web, eliminando bloqueos y mejorando el rendimiento * Mejor manejo de errores de inicio de sesión con mensajes explícitos de validación de correo electrónico - * Corregido el manejo de espacios en blanco en la validación de direcciones de correo electrónico + * Corrección del manejo de espacios en blanco en la validación de direcciones de correo electrónico - ## Correcciones de errores y confiabilidad + ## Corrección de errores y confiabilidad - * Corregida la actualización de sockets del enrutador de la app para funciones en tiempo real - * Corregidos problemas de renderizado de rutas SVG en la documentación - * Corregida la navegación por teclado en la búsqueda y el chat - * Mejorada la confiabilidad del endpoint de estado del historial - * Resueltos casos límite de middleware y problemas con el manejo del evento onClick + * Se corrigió la actualización de sockets del app router para las funciones en tiempo real + * Se corrigieron problemas de renderizado de rutas SVG en la documentación + * Se corrigió la navegación por teclado en la búsqueda y el chat + * Se mejoró la confiabilidad del endpoint de estado del historial + * Se resolvieron casos límite de middleware y problemas con el manejo del evento onClick - - ## Lanzamientos principales + + ## Lanzamientos importantes - * **Mejora importante**: Páginas sugeridas por IA en páginas 404, [cuando alguien llega a un enlace roto → el agente de IA lee la ruta → sugiere páginas semánticamente similares](https://x.com/mintlify/status/1966625627773059495) - * **Lanzamiento principal**: la búsqueda web para el assistant ahora puede incluir fuentes externas\ + * **Mejora importante**: páginas sugeridas por IA en páginas 404, [cuando alguien llega a un enlace roto → el agente de IA lee la ruta → sugiere páginas semánticamente similares](https://x.com/mintlify/status/1966625627773059495) + * **Lanzamiento importante**: la búsqueda web del assistant ahora puede incluir fuentes externas\ *Nota: Contáctanos para habilitar esta función en tu sitio.* ## Assistant y MCP - * Se corrigió un error por el que el assistant se limitaba por tasa de forma incorrecta debido a que la ventana de tiempo no se deslizaba correctamente + * Se corrigió un error por el que el assistant era limitado por tasa de forma incorrecta debido a que la ventana de tiempo no se deslizaba correctamente * Se corrigió un error en las llamadas a herramientas del assistant para manejar correctamente bloques `text` vacíos - * Se corrigió un error por el que los nombres del servidor Model Context Protocol (MCP) concatenados con llamadas a herramientas a veces excedían la longitud de 60 caracteres que imponen los clientes MCP - * Se corrigió un error por el que el menú del assistant tenía una altura varias veces mayor que el viewport y hacía scroll infinito + * Se corrigió un error por el que los nombres del servidor MCP concatenados con llamadas a herramientas a veces excedían la longitud de 60 caracteres que imponen los clientes MCP + * Se corrigió un error por el que el menú del assistant tenía una height varias veces mayor que el viewport y se desplazaba indefinidamente * Se corrigió un error por el que los valores de gasto del assistant podían mostrarse con más de dos decimales en el dashboard ## Editor web e implementaciones - * Mejora de seguridad en el editor para que solo los usuarios con `write permissions` en el repositorio Git conectado puedan realizar cambios + * Mejora de seguridad en el editor para que solo usuarios con `write permissions` en el repositorio de alojamiento Git conectado puedan realizar cambios * Se corrigió un error por el que las implementaciones de vista previa no funcionaban para branches con `=` en el nombre * Se corrigió un error por el que los nombres de branch largos desbordaban los modales al crear implementaciones de vista previa - * Mejora de usabilidad: el parámetro de búsqueda de correo electrónico ahora rellena previamente el campo en invitaciones de registro + * Mejora de usabilidad: el parámetro de búsqueda email ahora rellena previamente el campo en invitaciones de registro * Se corrigió un error por el que copiar una página desde el menú contextual no funcionaba en Safari ## Área de pruebas de la API y navigation - * Los múltiples códigos de respuesta del área de pruebas de la API ahora se muestran en un menú select con estilo controlado en lugar del menú select predeterminado del sistema al enfocarse - * Ahora puedes usar el [`expanded` en los groups de navigation en tu `docs.json` para que se abran por defecto](https://mintlify.com/docs/navigation#default-expanded-state) + * Múltiples códigos de respuesta del área de pruebas de la API ahora se muestran en un menú select con estilo controlado en lugar del menú select predeterminado del sistema al enfocarse + * Ahora puedes usar el [`expanded` field en los navigation groups de tu `docs.json` para que se abran por defecto](https://mintlify.com/docs/navigation#default-expanded-state) - ## SEO e interfaz de usuario + ## SEO y UI - * Se corrigió un error por el que los favicons no aparecían en los motores de búsqueda, sirviéndolos desde la misma URL que el sitio de documentación para cada sitio correspondiente - * Se corrigió un error por el que las inserciones de YouTube parpadeaban al cargar - * Se corrigió un error por el que al expandir el menú de feedback para incluir respuestas escritas se producía un cambio de diseño en la tabla de contenidos + * Se corrigió un error por el que los favicons no aparecían en los motores de búsqueda, sirviéndolos desde la misma URL que el propio sitio de documentación para cada sitio correspondiente + * Se corrigió un error por el que las inserciones de YouTube parpadeaban al cargarse + * Se corrigió un error por el que al ampliar el menú de comentarios para incluir respuestas escritas se producía un cambio de diseño en la tabla de contenido * Se corrigió un error por el que el texto se desbordaba por encima de la barra superior en el tema Maple al descartar el banner de notificación - * Se mejoraron los temas Maple y Willow añadiendo botones de inicio/cierre de sesión en la barra lateral para facilitar el acceso + * Se mejoraron los temas Maple y Willow añadiendo botones de iniciar/cerrar sesión en la barra lateral para un acceso más fácil ## Analytics y exportaciones - * Se corrigieron problemas de confiabilidad en la vista y las exportaciones de analytics del assistant + * Se corrigieron problemas de confiabilidad en la vista de analytics del assistant y en las exportaciones * Las exportaciones de analytics del assistant ahora se ejecutan en segundo plano y se envían por correo electrónico para una experiencia más confiable - + ## Lanzamiento principal: recopilación de comentarios mejorada - * **Mejora importante**: Ahora los lectores pueden dar comentarios más detallados después de seleccionar *pulgar arriba/abajo*, incluyendo opciones y comentarios escritos. También puedes recopilar comentarios en bloques de código y ver todas las respuestas en los Analytics de tu dashboard.\ + * **Mejora importante**: Los lectores ahora pueden dar comentarios más detallados después de seleccionar *pulgar arriba/abajo*, incluidas opciones y comentarios escritos. También puedes recopilar comentarios en bloques de código y ver todas las respuestas en los Analytics de tu dashboard.\ *Nota: Contáctanos para habilitar esta función en tu sitio.* - ## Mejoras de navegación y usabilidad + ## Mejoras de navegación y de experiencia - * Mejora de usabilidad para ignorar las barras finales y dobles, para que no tengas que preocuparte por ponerlas exactamente bien en tu docs.json + * Mejora de experiencia para ignorar barras finales y dobles barras, para que no tengas que preocuparte por ponerlas exactamente bien en tu docs.json * Ahora puedes añadir un atributo `noAnchor` a tus etiquetas HTML `h1-6` para evitar que tengan un enlace de ancla - * El tema Palm ahora incluye un selector de idioma flotante en la esquina inferior izquierda, similar al enfoque de Stripe - * Se añadió un nuevo campo a docs.json llamado [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) que te permite controlar si los usuarios son dirigidos a la primera página de un grupo de navegación cuando el grupo se expande - * Mejora de usabilidad para que las listas ordenadas anidadas alternen estilos de decimal/romano a alfabético + * El tema Palm ahora tiene un selector de idioma flotante en la parte inferior izquierda, similar al enfoque de Stripe + * Se añadió un nuevo campo al docs.json llamado [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) que te permite controlar si los usuarios son llevados o no a la primera página de un grupo de navegación cuando el grupo se expande + * Mejora de experiencia para que las listas ordenadas anidadas alternen estilos de decimal/romano a alfabético ## Correcciones de errores y confiabilidad - * Se corrigió un error por el que los enlaces de ancla de posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página + * Se corrigió un error en el que los enlaces de ancla con posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página * Se corrigió un error por el que Google estaba indexando archivos `*.md` sin procesar porque les faltaba el encabezado `x-robots-tag: noindex` - * Se corrigió un error con OAuth en documentación protegida por el que no te redirigía a tu página inicial una vez completado correctamente el flujo - * Se corrigió un error en las vistas previas de documentación protegida con autenticación por el que no se podía ver toda la barra de navegación - * Correcciones en cómo se manejan los SVG con nuestra nueva CDN de imágenes + * Se corrigió un error con OAuth en la documentación protegida por autenticación en el que no te redirigía a tu página de inicio una vez completado el flujo con éxito + * Se corrigió un error en las vistas previas de documentación protegida por autenticación en el que no podías ver toda la barra de navegación + * Correcciones de errores en cómo se manejan los SVG con nuestra nueva CDN de imágenes ## Mejoras de componentes y estilos @@ -100,195 +100,195 @@ noindex: true * Mejora de rendimiento al mover el CSS de KaTeX de cdnjs a nuestra propia CDN en CloudFront para reducir la latencia - + ## Mejoras en el manejo de imágenes - * **Mejora importante**: Las imágenes ya no provocan cambios de diseño por defecto, incluso cuando no se especifican los atributos width y height; el dimensionamiento automático evita saltos de contenido durante la carga de la página - * Todos los archivos estáticos de tu repositorio (PDF, TXT, XML, etc.) ahora se cargan y sirven automáticamente cuando implementas, proporcionando cobertura completa de recursos + * **Mejora importante**: Las imágenes ya no provocan desplazamiento del diseño de forma predeterminada, incluso cuando no se especifican los atributos width y height; el dimensionamiento automático evita saltos de contenido durante la carga de páginas + * Todos los archivos estáticos en tu repositorio (PDF, TXT, XML, etc.) ahora se suben y sirven automáticamente cuando implementas, proporcionando cobertura completa de recursos ## Mejoras del editor web e implementación - * Se corrigió el flujo de creación de branch en el editor web para navegar correctamente a, y permanecer en, las nuevas ramas creadas - * Diálogo de conflictos de fusión mejorado con funcionalidad de escape adecuada; ya no se requieren recargas de página para descartar conflictos - * Flujo de actualización optimizado al invalidar caché solo de las páginas cambiadas durante actualizaciones parciales, reduciendo los tiempos de implementación + * Se corrigió el flujo de creación de branch en el editor web para navegar correctamente a y permanecer en las ramas recién creadas + * Se mejoró el cuadro de diálogo de resolución de conflictos con una función de cierre adecuada; ya no se requieren recargas de página para descartarlos + * Se optimizó el rendimiento del flujo de actualización invalidando la caché solo de las páginas cambiadas durante actualizaciones parciales, reduciendo los tiempos de implementación ## Mejoras de autenticación y navegación * Nuevo soporte para autenticación en subdirectorios personalizados; si sirves la documentación en `https://yourdomain.com/docs`, la autenticación ahora funciona sin problemas * Se corrigió un error de visualización en la barra lateral que aparecía incorrectamente cuando solo se configuraba un enlace - * Renovación integral de la navegación móvil: botones centrados con márgenes/espaciado adecuados, mejora del espaciado en menús desplegables, eliminación de divisores y márgenes innecesarios para secciones vacías, y corrección de problemas de separación/espaciado en el tema Maple + * Renovación integral de la navegación móvil: botones centrados con margen/espaciado adecuados, mejor espaciado en menús desplegables, eliminación de divisores y márgenes innecesarios para secciones vacías, y corrección de problemas de separación/espaciado en el tema Maple ## Correcciones de componentes y estilos - * Se resolvió el problema de conversión de etiquetas `` que las transformaba incorrectamente en componentes Heading y afectaba el estilo personalizado - * Se agregó un interruptor de configuración del assistant con un clic en el dashboard para facilitar la gestión + * Se resolvió el problema de conversión de etiquetas `` que las transformaba incorrectamente en componentes Heading y alteraba los estilos personalizados + * Se agregó un interruptor de configuración del assistant con un clic en el dashboard para una gestión más sencilla ## Mejoras técnicas y confiabilidad - * Sistema de logging mejorado para los flujos de actualización, lo que permite una depuración y resolución de problemas más rápidas - * Se corrigió la limitación de tasa de GitHub para clientes con más de 10 especificaciones de OpenAPI/AsyncAPI al cambiar de la obtención de archivos individuales a la clonación del repositorio - * Se mejoró la confiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límite de tasa y una funcionalidad de búsqueda más robusta + * Sistema de logging mejorado para flujos de actualización que permite una depuración más rápida y una resolución de problemas más ágil + * Se solucionó la limitación de tasa de GitHub para clientes con más de 10 especificaciones OpenAPI/AsyncAPI, pasando de la obtención de archivos individuales a la clonación del repositorio + * Se mejoró la confiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límites de tasa y una herramienta de búsqueda más robusta - - ## Optimizaciones de rendimiento y de compilación + + ## Optimizaciones de rendimiento y compilación - * La transpilación de MDX ahora ocurre en el momento de la implementación, en lugar de en cada carga de página en entornos serverless de NextJS sin caché, lo que mejora el tiempo hasta el primer byte en páginas sin caché. - * El hashing basado en contenido evita la retranspilación cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) - * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos adicionales y a la paralelización de consultas en nuestro backend - * Se redujo el tamaño de la página eliminando datos `navigation` duplicados en la carga `rsc` de cada página; las mejoras de rendimiento son más notorias con un alto número de páginas o estructuras de navegación complejas - * Un prefetching más agresivo permite cargas de página instantáneas con mayor frecuencia + * La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos serverless de NextJS sin caché, mejorando el tiempo hasta el primer byte para páginas sin caché. + * El hash basado en contenido evita la retranspilación cuando el MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) + * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos adicionales y paralelización de consultas en nuestro backend + * Se redujo el tamaño de la página eliminando datos duplicados de `navigation` en la carga útil `rsc` de cada página; las mejoras de rendimiento son más notables con un alto número de páginas o estructuras de navegación complejas + * Un prefetching más agresivo permite cargas de página casi instantáneas con mayor frecuencia - ## Mejoras en el área de pruebas de la API y en OpenAPI + ## Área de pruebas de la API y mejoras en OpenAPI - * La conversión de OpenAPI a MCP se trasladó al backend, lo que permite que los servidores MCP alojados incluyan herramientas (pronto habrá documentación y opciones de configuración más claras) - * Se agregó compatibilidad con Ruby al área de pruebas de la API - * Agregamos una función para que ahora puedas [especificar páginas de la API usando únicamente tu docs.json](/es/api-playground/openapi-setup#auto-populate-api-pages) sin crear nuevos archivos mdx. - * Compatibilidad con páginas de [`webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI - * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlaces de anclaje de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores + * La conversión de OpenAPI a MCP se trasladó al backend, lo que permite que los servidores MCP alojados contengan herramientas (pronto habrá documentación y opciones de configuración más claras) + * Se añadió compatibilidad con Ruby al área de pruebas de la API + * Agregamos una función con la que ahora puedes [especificar páginas de la API usando solo tu docs.json](/es/api-playground/openapi-setup#auto-populate-api-pages) sin crear nuevos archivos mdx. + * Compatibilidad con [páginas `webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI + * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlace de anclaje de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores ## Mejoras del editor web - * La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera, en lugar de requerir presionar la tecla Enter - * Se corrigió la navegación de branch, donde cambiar la URL a un branch específico redirigía al último branch activo en lugar del destino previsto - * Se codifican correctamente en la URL los títulos de branch que contienen `/` para evitar errores de navegación - * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard de monorepos, que estaba anteponiendo la ruta del repositorio de docs y creando enlaces rotos + * La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera en lugar de requerir presionar la tecla Enter + * Se corrigió la navegación por branch en la que cambiar la URL a una branch específica redirigía a la última branch activa en lugar del destino previsto + * Codificación adecuada de URL para títulos de branch que contienen `/` para evitar roturas de la navegación + * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard de monorepos que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos ## Analytics e integraciones con LLM - * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: añádelos a la raíz del repositorio de docs para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para la personalización de LLM - * Se agregó la [integración de Analytics de Hightouch](/es/integrations/analytics/hightouch#hightouch) - * Seguimiento mejorado de Analytics en el menú contextual (la visualización en el dashboard llegará pronto) - * Se agregaron pruebas de extremo a extremo para `llms.txt` y `llms-full.txt` para garantizar su correcta entrega + * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para personalización de LLM + * Se añadió la [integración de Analytics de Hightouch](/es/integrations/analytics/hightouch#hightouch) + * Seguimiento de analytics del menú contextual mejorado (la visualización en el dashboard llegará pronto) + * Se añadieron pruebas de extremo a extremo para `llms.txt` y `llms-full.txt` para garantizar una entrega correcta - ## Mejoras de componentes y estilos + ## Mejoras de componentes y estilo * Compatibilidad con classnames personalizados en etiquetas `h{1-4}` para aplicar estilos de encabezado personalizados * Se corrigió que las etiquetas `h{1-4}` se renderizaran como componentes `Heading` con chips en el modo de página personalizada - * Se agregaron selectores CSS a [breadcrumbs](/es/navigation#breadcrumbs) para una segmentación CSS personalizada - * Se corrigieron imágenes de Open Graph estiradas analizando sus dimensiones para mantener las proporciones a 56px de height + * Se añadieron selectores CSS a [breadcrumbs](/es/navigation#breadcrumbs) para aplicar CSS personalizado + * Se corrigieron imágenes de open graph estiradas analizando dimensiones para mantener las proporciones a 56px de height * Se corrigió `VSCode` a `VS Code` en el menú contextual cuando está habilitado * Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenido junto con los encabezados semánticos ## Correcciones de errores y confiabilidad - * Se corrigieron problemas de renderizado de PDF con ciertos títulos de página, saneando caracteres que causaban problemas de generación - * Se solucionó el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos JSON de OpenAPI vacíos - * Se corrigió que las metatags de Open Graph personalizadas en `docs.json` fueran sobrescritas por las generadas - * Se corrigieron los clics del botón de RSS al aterrizar en enlaces de anclaje, usando origin + pathname para los enlaces de RSS + * Se corrigieron problemas de renderizado de PDF con ciertos títulos de página al sanear caracteres que causaban problemas de generación + * Se resolvió el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos JSON de OpenAPI vacíos + * Se corrigió que las metatags de open graph personalizadas de `docs.json` fueran sobrescritas por las generadas + * Se corrigieron los clics del botón del feed RSS al aterrizar en enlaces de anclaje usando origin + pathname para los enlaces de RSS * Se mejoró la velocidad de descarga de la CLI eliminando sourcemaps ## Mejoras técnicas - * Se agregaron pruebas visuales a la canalización de CI para detectar regresiones antes + * Se añadieron pruebas visuales al pipeline de CI para una detección más temprana de regresiones * Se mejoró el manejo de errores y las capacidades de depuración - * Cobertura de pruebas integral para nuevas funciones y casos extremos + * Cobertura de pruebas integral para nuevas funciones y casos límite - + ## Mejoras de autenticación - * Acceso público a nivel de grupo: haz públicos grupos completos de páginas mediante `docs.json` para que no necesites `public: true` en cada página ([más información](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) + * Acceso público a nivel de grupo: haz públicos grupos de páginas completos mediante `docs.json` para no tener que añadir `public: true` en cada página ([más información](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) * Compatibilidad con [`logoutURL` en la configuración de OAuth](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) para eliminar cookies de origen y completar el cierre de sesión - * En errores de OAuth, los usuarios se redirigen al `logoutURL` especificado para reiniciar el flujo de autenticación - * Se corrigió un destello de error 500 durante los flujos de OAuth/JWT antes del callback - * Eliminación automática de `https://` de las URL en la configuración de autenticación OAuth/JWT para prevenir configuraciones incorrectas + * En caso de errores de OAuth, los usuarios se redirigen a tu `logoutURL` especificado para reiniciar el flujo de autenticación + * Solucionado un parpadeo de error 500 durante los flujos de OAuth/JWT antes del callback + * Eliminación automática de `https://` de las URL en la configuración de autenticación OAuth/JWT para evitar errores de configuración ## Mejoras del área de pruebas de la API - * Nuevo [endpoint de Search API](https://mintlify.com/docs/api-reference/assistant/search) para que puedas crear agentes y servidores MCP sobre tu documentación + * Nuevo [endpoint de la Search API](https://mintlify.com/docs/api-reference/assistant/search) para que puedas crear agentes y servidores MCP sobre tu documentación * Los archivos `openapi` y `asyncapi` ahora se sirven en sus rutas especificadas (por ejemplo, `https://mydocsurl.extension/{openapi-or-file-name}.json`) - * Ahora puedes usar el [campo `x-mint` en tus archivos openapi](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) para sobrescribir campos generados, personalizar el contenido de introducción o cambiar URL de endpoints en ejemplos de código + * Ahora puedes usar el [campo `x-mint` en tus archivos openapi](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) para sobrescribir campos generados, personalizar el contenido de introducción o cambiar las URL de endpoints en los ejemplos de código * [`x-mcp` ahora es `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp) en configuraciones de OpenAPI para controlar qué rutas se exponen como herramientas MCP ## Actualizaciones del assistant - * Se corrigió un problema donde el menú de acciones (con opciones como copiar y pulgar arriba) para mensajes antiguos desaparecía cuando llegaban nuevos mensajes en streaming - * Se corrigió la accesibilidad de las páginas anidadas `/mcp/...` después del [lanzamiento de servidores MCP alojados](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) de la semana pasada + * Se solucionó un problema por el cual el menú de acciones (con opciones como copiar y pulgar arriba) de mensajes antiguos desaparecía cuando llegaban nuevos mensajes en streaming + * Se corrigió la accesibilidad de páginas anidadas `/mcp/...` tras el [lanzamiento de servidores MCP alojados](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server) de la semana pasada - ## Rendimiento y fiabilidad + ## Rendimiento y confiabilidad - * Todos los assets de imagen y video presentes en tu repositorio de documentación ahora se sirven en la ruta correspondiente en tu domain. Por ejemplo, si tienes `/assets/marketing/my-logo.png` en tu repositorio, estará disponible en `https://mydocsurl.extension/assets/marketing/my-logo.png`. + * Todos los recursos de imagen y video presentes en tu repositorio de documentación ahora se sirven en la ruta adecuada en tu domain. Por ejemplo, si tienes `/assets/marketing/my-logo.png` en tu repositorio, estará disponible en `https://mydocsurl.extension/assets/marketing/my-logo.png`. * El campo de email en el inicio de sesión del Dashboard de Mintlify ahora tiene autofocus para que puedas empezar a escribir de inmediato *(mejora de calidad de vida)* - * Tanto los dominios personalizados como los subdomains en Redis para una mejora del rendimiento en los tiempos de carga de la navigation (~50 ms de reducción de latencia) - * Se agregó lógica de reintento para exportaciones a PDF para mejorar la fiabilidad - * Se corrigió que el aviso de consentimiento de cookies reapareciera después de aceptar o descartar—ahora se respeta la primera selección - * Se corrigió copiar una página al portapapeles en Safari especificando un `type` MIME en `navigator.write` + * Tanto los dominios personalizados como los subdomains en Redis para mejorar el rendimiento en los tiempos de carga de la navigation (~50 ms menos de latencia) + * Se añadió lógica de reintentos para exportaciones a PDF y mejorar la confiabilidad + * Se corrigió que el popup de consentimiento de cookies reapareciera tras la aceptación o el rechazo: ahora se respeta la primera selección + * Se solucionó copiar una página al portapapeles en Safari especificando un `type` MIME en `navigator.write` ## Mejoras técnicas - * Correcciones de errores de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones - * Salida de registro de errores mejorada: una mejora de calidad de vida para nuestro equipo de ingeniería al depurar + * Correcciones de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones + * Salida de logs de errores mejorada: una mejora de calidad de vida para nuestro equipo de ingeniería al depurar * Correcciones menores a la acción de CI de enlaces rotos cuando faltan archivos `contentDirectory` * Se corrigió una regresión causada por las correcciones de la vista previa protegida por autenticación de la semana pasada, donde la Tab activa no se establecía correctamente en la UI de navigation * Se corrigió que el color de fondo light del tema no se aplicara a los iconos de la Tab activa - * Se corrigió un problema donde cambiar el tipo de autenticación en el dashboard se actualizaba y luego volvía al tipo guardado previamente—ahora la nueva selección persiste después de guardar - * Mejoras internas de DX para clientes enterprise con bibliotecas de UI personalizadas—ahora nos resulta más fácil incluir tus componentes y atender solicitudes en plazos más cortos + * Se solucionó un problema por el cual cambiar el tipo de autenticación en el dashboard se actualizaba y luego volvía al tipo guardado previamente: ahora la nueva selección persiste tras guardar + * Mejoras internas de DX para clientes empresariales con bibliotecas de UI personalizadas: ahora nos resulta más fácil incluir tus componentes y atender solicitudes en plazos más cortos ## Mejoras de autenticación - * Mejoras para el desarrollo local de auth, lo que permite crear funciones y corregir errores de auth más rápido en esta área del producto - * Implementaciones de vista previa ahora disponibles para sitios protegidos por auth + * Mejoras en el desarrollo local de autenticación, lo que permite un desarrollo más rápido de funciones y correcciones de errores en esta área del producto + * Implementaciones de vista previa ahora disponibles para sitios protegidos por autenticación * Se corrigió el comportamiento de redirección para devolver correctamente a los usuarios a su página original después de autenticarse - * Se corrigió la visualización del botón de cierre de sesión para la autenticación completa (antes solo funcionaba con autenticación parcial) + * Se corrigió la visualización del botón de cerrar sesión para la autenticación completa (antes solo funcionaba con autenticación parcial) ## Mejoras del área de pruebas de la API - * Se corrigió la carga de archivos con `multipart/form-data` en el área de pruebas de la API - * Se corrigió el comportamiento de los enlaces de anclaje para que al hacer clic actualicen la URL sin desplazarse a la parte superior de la página - * Se corrigieron problemas con enlaces de anclaje en pestañas anidadas + * Se corrigió la carga de archivos `multipart/form-data` en el área de pruebas de la API + * Se corrigió el comportamiento de los enlaces de anclaje para que al hacer clic actualicen la URL sin desplazarse al inicio de la página + * Se corrigieron problemas de enlaces de anclaje en pestañas anidadas ## Actualizaciones del assistant * Nueva Assistant API para que puedas integrarlo en tus propios productos, compatible con el SDK de IA * Se agregó un botón para copiar en las respuestas del chat * Se corrigió un problema al reintentar mensajes en el assistant - * Mejoras al prompt predeterminado del assistant para que sea menos verboso por defecto + * Mejoras al prompt predeterminado del assistant para que sea menos verboso de forma predeterminada ## Rendimiento y confiabilidad - * La búsqueda se siente más ágil y precisa al abortar solicitudes con debounce mientras escribes + * La búsqueda ahora se siente más ágil y precisa al abortar solicitudes con debounce a medida que escribes * Aprovisionamiento de recursos para una nueva CDN: se espera que los tiempos de carga de imágenes y de páginas mejoren pronto - * Se corrigieron errores al renderizar diagramas complejos de Mermaid como gráficos GANTT - * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para prevenir regresiones + * Se corrigieron errores al renderizar diagramas Mermaid complejos como gráficos de Gantt + * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para evitar regresiones ## Mejoras técnicas - * Se agregó OpenTelemetry para trazas en la aplicación Next.js con el fin de mejorar el tiempo hasta el primer byte para los clientes + * Se agregó OpenTelemetry para trazas en la aplicación NextJS para mejorar el tiempo hasta el primer byte para los clientes * Se migró de Octokit a GitHub API Client para mejorar la latencia en la experiencia del editor web - * Se corrigieron meta tags duplicadas para OpenGraph + * Se corrigieron etiquetas meta duplicadas para OpenGraph * Se actualizó MongoDB de la versión 6 a la 7 para mejorar el rendimiento y añadir nuevas funciones ## Slack app - * Acceso sin fricción: el bot responde a DMs, @mentions y cualquier pregunta en tu canal `#ask-ai` - * Configuración con un clic: instala directamente desde tu Dashboard de Mintlify en segundos - * Respuestas contextuales: busca en toda tu documentación para proporcionar respuestas relevantes y precisas - * Reduce las interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio + * Acceso sin fricción: el bot responde a DMs, @menciones y cualquier pregunta en tu canal `#ask-ai` + * Configuración con un clic: instálala directamente desde tu Dashboard de Mintlify en segundos + * Respuestas contextuales: busca en toda tu documentación para ofrecer respuestas relevantes y precisas + * Reduce interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio - Obtén más información en nuestra [guía de la app de Slack](/es/ai/slack-app). + Obtén más información en nuestra [guía de Slack app](/es/ai/slack-app). ## Servidores MCP alojados - Implementa servidores del Model Context Protocol (MCP) alojados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). + Implementa servidores de Model Context Protocol (MCP) alojados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). Ayuda a los usuarios a conectar rápidamente tu servidor MCP con Cursor o VS Code desde cualquier página de tu documentación mediante el menú contextual. Consulta [Menú contextual](/es/ai/contextual-menu) para más información. - ## Mejoras del bloque de código + ## Mejoras en el bloque de código * Resaltado de sintaxis mejorado - * Se agregaron más opciones de personalización, incluido el modo de enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de lenguaje, numeración de líneas e íconos + * Se agregaron más opciones de personalización, incluyendo modo de enfoque, bloques de código expandibles, respuesta a modos oscuro y light, menú desplegable de lenguaje, numeración de líneas e iconos ## Actualizaciones del Asistente de IA - * Mayor precisión mediante RAG agente con llamadas a herramientas - * Proporciona enlaces navegables a las páginas referenciadas para que los usuarios vayan directamente a la fuente de las respuestas + * Mayor precisión mediante RAG agentivo con llamadas a herramientas + * Proporciona enlaces navegables a las páginas de referencia para que los usuarios puedan ir directamente a la fuente de las respuestas * Atajo para copiar ejemplos de código generados por el assistant * Atajo "Ask AI" en bloques de código de la documentación para generar explicaciones desde el assistant @@ -307,8 +307,8 @@ noindex: true * Búsqueda para encontrar un endpoint * Indica un endpoint en desuso con una etiqueta - * Oculta páginas de API autogeneradas de navigation - * Carga archivos multipart o datos de formulario + * Oculta las páginas de API autogeneradas de la navigation + * Carga archivos multipart o de datos de formulario Obtén más información en la [documentación del área de pruebas de la API.](/es/api-playground/) @@ -324,11 +324,11 @@ noindex: true ![Webeditor3 Jpe](/images/webeditor3.jpeg) - Se renovó la usabilidad del editor WYSIWYG. + Se renovó por completo la usabilidad del editor WYSIWYG. **Mejoras importantes** - * Busca nombres de archivo con el atajo ⌘ + P + * Busca nombres de archivos con el atajo ⌘ + P * Las páginas cargan 10 veces más rápido * Cargas más rápidas al buscar una branch * Pestaña de opciones de página para configurar el diseño, el título y la metadata para SEO @@ -336,14 +336,14 @@ noindex: true **Correcciones adicionales** - * Corregido el margen superior de los componentes del changelog + * Se corrigió el margen superior de los componentes del changelog * Mayor fiabilidad del comportamiento del clic derecho - * Tras hacer clic en Publicar, permanecerás en la misma página en lugar de ir a un estado vacío - * Colores estandarizados en los iconos de archivo - * Mayor fiabilidad después de seleccionar nuevas branch varias veces seguidas + * Después de hacer clic en publicar, te mantendrás en la misma página en lugar de ver un estado vacío + * Colores estandarizados en los iconos de archivos + * Mayor fiabilidad tras seleccionar nuevas branches varias veces seguidas * Se eliminó el modo Diff - * Más coherencia al crear una carpeta nueva desde el menú desplegable - * Corregido: las citas en bloque creaban más citas al intentar deseleccionar + * Más consistencia al crear una carpeta nueva desde el menú desplegable + * Se corrigió que las citas en bloque crearan más citas en bloque al intentar deseleccionar ## Traducciones con IA en beta @@ -357,9 +357,9 @@ noindex: true Exporta toda tu documentación, un subdirectorio o una sola página como PDF. - ## Compatibilidad con React hooks + ## Compatibilidad con hooks de React - Añade interactividad a tu documentación. Todos los React hooks estándar están disponibles automáticamente en tus archivos MDX. [Más información.](es/react-components) + Añade interactividad a tu documentación. Todos los hooks estándar de React están disponibles automáticamente en tus archivos MDX. [Más información.](es/react-components) @@ -369,22 +369,22 @@ noindex: true ![screenshot of MCP server generator](/images/changelog/mcpgenerator.png) - Genera servidores MCP para que las aplicaciones de IA puedan interactuar con tu documentación o APIs. El contenido escrito se genera automáticamente como un servidor MCP y puedes generar un servidor MCP desde tu especificación OpenAPI con un solo clic. - Consulta la [documentación para empezar con MCP.](/es/ai/model-context-protocol) + Genera servidores MCP para que las aplicaciones de IA puedan interactuar con tu documentación o APIs. El contenido escrito se genera automáticamente como un servidor MCP y puedes generar un servidor MCP desde tu especificación de OpenAPI con un solo clic. + Consulta la [documentación para comenzar con MCP.](/es/ai/model-context-protocol) ## Mejoras * Etiqueta las actualizaciones del changelog para que los usuarios finales puedan filtrarlas - * Sonnet-3.7 compatible con AI Chat. Configura tu modelo preferido desde el dashboard + * Sonnet-3.7 compatible para el chat de IA. Configura tu modelo preferido desde el dashboard * Cambia el nombre de tu implementación directamente en la configuración del dashboard ## Correcciones de errores * Imágenes OG corregidas * Corregida la inconsistencia de estilo de icon para anclajes sin contenedor - * Ajustes de estilo en el borde del dashboard para la adaptabilidad móvil-tablet-escritorio - * Mostrar ejemplos de código incluso en modo simple en el área de pruebas de la API - * Compatibilidad con el atajo "command + k" para la búsqueda en el editor web + * Pequeñas mejoras de estilo en el borde del dashboard para la adaptación móvil-tablet-escritorio + * Mostrar ejemplos de código incluso en modo simple para el área de pruebas de la API + * Compatibilidad con el atajo "command + k" para buscar en el editor web * Los bloques de código dentro de los callouts se expanden para ocupar el width del área del callout @@ -395,11 +395,11 @@ noindex: true ![captura de pantalla de docs.json](/images/changelog/docsjson.png) - Hemos introducido un nuevo esquema `docs.json` como reemplazo de `mint.json`, para permitir un mejor versionado multinivel, facilitar la comprensión visual y unificar la terminología. Para obtener más información sobre lo que ha cambiado, [consulta nuestro blog](https://mintlify.com/blog/refactoring-mint-json-into-docs-json). + Hemos introducido un nuevo esquema `docs.json` como reemplazo de `mint.json`, para admitir un mejor versionado multinivel, una comprensión visual más sencilla y una terminología más coherente. Para más información sobre los cambios, [consulta nuestro blog](https://mintlify.com/blog/refactoring-mint-json-into-docs-json). - Actualiza de `mint.json` a `docs.json` con los siguientes pasos: + Actualiza de `mint.json` a `docs.json` con estos pasos: - 1. Asegúrate de que tu CLI esté en la última versión + 1. Asegúrate de tener la CLI en su última versión ```bash npm i mint@latest -g @@ -411,15 +411,15 @@ noindex: true mint upgrade ``` - 1. Elimina el archivo `mint.json` antiguo y haz push de tus cambios + 1. Elimina tu archivo antiguo `mint.json` y sube los cambios - ## Verificaciones de CI + ## Comprobaciones de CI - Ejecuta lint automáticamente sobre tu documentación para encontrar enlaces rotos, detectar errores ortográficos y gramaticales, o aplicar estilos de redacción con tu propia configuración de Vale. Obtén más información en nuestra [documentación](es/settings/ci). + Ejecuta un lint automático en tu documentación para detectar enlaces rotos, errores ortográficos y gramaticales, o para aplicar guías de estilo con tu propia configuración de Vale. Más información en nuestra [documentación](es/settings/ci). - ## Compatibilidad .md para LLMs + ## Compatibilidad .md para LLM - Todas las páginas de documentación ahora están disponibles automáticamente como archivos Markdown sin formato: solo agrega `.md` a la URL. Esto facilita que los LLMs incorporen páginas individuales de tu documentación. + Todas las páginas de documentación ahora están disponibles automáticamente como archivos Markdown sin formato: solo añade `.md` a la URL. Esto facilita que los LLM procesen páginas individuales de tu documentación. ## Más temas @@ -437,34 +437,34 @@ noindex: true ## Otras mejoras - * [Guía de redacción técnica:](https://mintlify.com/guides/introduction) mejores prácticas para escribir documentación técnica, incluida la investigación de audiencia, tipos de contenido y consejos de escritura. - * [Componente Dropdown](es/navigation#dropdowns): organiza la navegación con un menú desplegable, además de pestañas y anclajes. - * [Corrector de sintaxis con IA](https://x.com/ricardonunez_io/status/1892334887644123192): el editor web detectará si hay un error de análisis y usará IA para sugerir correcciones. + * [Guía de redacción técnica:](https://mintlify.com/guides/introduction) Mejores prácticas para escribir documentación técnica, incluyendo investigación de audiencia, tipos de contenido y consejos de redacción. + * [Componente Dropdown](es/navigation#dropdowns): Organiza la navigation con un menú desplegable, además de pestañas y anclas. + * [Corrector de sintaxis con IA](https://x.com/ricardonunez_io/status/1892334887644123192): El editor web detectará si hay un error de análisis y usará IA para sugerir correcciones. ## Mejoras del Asistente de IA - * Nueva interfaz con página de chat dedicada y prompts prellenados - * Mejoras de estabilidad. Por ejemplo, corrección de errores al editar el archivo equivocado o ninguno + * Nueva UI con página de chat dedicada y prompts prellenados + * Mejoras de estabilidad. Por ejemplo, correcciones de errores al editar el archivo equivocado o ninguno * Conocimiento más sólido para agregar y editar componentes * Edición mejorada del archivo `docs.json` ## Autenticación parcial - Personaliza el acceso a cualquier página o sección de contenido según los permisos del usuario. Admite la conexión con tu propio sistema de autenticación. + Personaliza el acceso a cualquier página o sección de contenido según los permisos del usuario. Permite conectarse con tu propio sistema de autenticación. ## Área de pruebas de la API renovada Hemos renovado el diseño y el rendimiento del [área de pruebas de la API](/es/api-playground/). Las actualizaciones incluyen: * Expansión de detalles más sencilla para obtener una vista general de un campo - * Diseño anidado más intuitivo. Por ejemplo, al agregar o eliminar elementos + * Diseño anidado más intuitivo. Por ejemplo, agregar o eliminar elementos * Tiempos de respuesta más rápidos ## Mejoras de calidad - * Compatibilidad para requerir autenticación para acceder a implementaciones de vista previa + * Compatibilidad para exigir autenticación para acceder a implementaciones de vista previa @@ -474,21 +474,21 @@ noindex: true ![captura de pantalla de Autenticación](/images/changelog/authentication.png) - Vuelve privada la documentación configurando la autenticación mediante JWT (JSON Web Token), OAuth o una contraseña universal. Con esta protección, puedes crear una base de conocimiento interna o evitar que los competidores vean tu documentación. + Haz privada la documentación configurando la autenticación mediante JWT (JSON Web Token), OAuth o una contraseña universal. Con esta privacidad, puedes crear una base de conocimiento interna o evitar que los competidores vean tu documentación. - ## Redactor de IA + ## Redactor con IA ![Asistente de IA](/images/changelog/ai-assistant.jpg) - Ahora puedes pedirle a la IA que haga cambios en tu documentación, usando el contexto de toda la documentación existente. Escribe una indicación y el redactor propondrá cambios generando una solicitud de extracción. + Ahora puedes pedirle a la IA que haga cambios en tu documentación con el contexto de todo el contenido existente. Escribe una instrucción y el redactor propondrá cambios generando una solicitud de extracción. ## Mejora de la integración con GitLab - Hemos mejorado la compatibilidad de la sincronización con GitLab, incluyendo actualizaciones automatizadas y implementaciones de vista previa. Consulta nuestra [documentación sobre GitLab](/es/settings/gitlab) para comenzar. + Hemos mejorado la sincronización con GitLab, habilitando actualizaciones automatizadas y implementaciones de vista previa. Consulta nuestra [documentación sobre GitLab](/es/settings/gitlab) para comenzar. ## Editor web @@ -496,9 +496,9 @@ noindex: true ![Editor web](/images/changelog/webeditor.jpg) - Hemos renovado nuestro editor web para que ahora puedas actualizar la documentación con una experiencia totalmente WYSIWYG, mientras se sincroniza con Markdown. + Hemos renovado nuestro editor web para que puedas actualizar la documentación con una experiencia totalmente WYSIWYG, mientras se sincroniza con Markdown. - Consulta nuestra [documentación para empezar con el editor web](/es/editor). + Consulta nuestra [documentación para comenzar con el Editor web](/es/editor). ## Compatibilidad con /llms.txt @@ -506,7 +506,7 @@ noindex: true ![Compatibilidad con llms.txt](/images/changelog/llms.jpg) - Todas las instancias de documentación ahora se alojan automáticamente en /llms.txt y /llms-full.txt para que los LLM puedan ingerir tu documentación fácilmente. Para obtener más información, lee la [documentación sobre el nuevo estándar llms.txt.](https://llmstxt.org) + Todas las instancias de documentación ahora se alojan automáticamente en /llms.txt y /llms-full.txt para que los LLM puedan ingerir tu documentación con facilidad. Para obtener más información, lee la [documentación sobre el nuevo estándar llms.txt.](https://llmstxt.org) ## Localización @@ -524,12 +524,12 @@ noindex: true Lanzamos un nuevo [componente Update](/es/components/update) para facilitar la visualización y comunicación de actualizaciones (como esta) a tus usuarios. - ![Cambios](/images/changelog/changelog.jpg) + ![Registro de cambios](/images/changelog/changelog.jpg) ## Resaltado de líneas de código - Ahora puedes resaltar líneas de código en tu documentación para enfatizar y dirigir la atención a partes importantes agregando un comentario especial después del identificador del lenguaje. Usa llaves `{}` y especifica números de línea o rangos separados por comas. + Ahora puedes resaltar líneas de código en tu documentación para enfatizar y llamar la atención sobre partes importantes agregando un comentario especial después del identificador del lenguaje. Usa llaves `{}` y especifica números de línea o rangos separados por comas. ```javascript Line Highlighting Example {1,3-5} const greeting = "Hello, World!"; @@ -566,38 +566,38 @@ noindex: true Ahora puedes agregar más enlaces al pie de página estándar. Esta mejora - aporta más coherencia entre páginas de destino y documentación, o mayor personalización - si deseas destacar páginas específicas como redes sociales o registros de estado. + ofrece mayor coherencia entre páginas de destino y documentación, o más personalización + si quieres destacar páginas específicas como redes sociales o registros de estado. ## Filtrar la búsqueda según el usuario actual - Cuando la personalización está habilitada, los resultados de búsqueda ahora se filtran según el usuario que haya iniciado sesión, de modo que solo vea el contenido relevante. + Cuando la personalización está habilitada, los resultados de búsqueda ahora se filtran según el usuario que ha iniciado sesión para que solo vea el contenido relevante. ## Prompts personalizados para el chat de IA - Ahora puedes personalizar los prompts del chat de IA. Comunícate con [support](mailto:support@mintlify.com) si deseas personalizar los prompts. + Ahora puedes personalizar los prompts para el chat de IA. Comunícate con [support](mailto:support@mintlify.com) si quieres personalizar los prompts. - ## Mejoras en el dashboard + ## Mejoras del dashboard - * Se añadió la capacidad de cambiar el dominio personalizado a /docs directamente desde la configuración del dashboard. - * Se unificaron las páginas de inicio de sesión y registro para reducir la fricción y la confusión. - * Se implementó el flujo de inicio de sesión de descubrimiento para que los usuarios que son miembros de múltiples organizaciones ahora puedan alternar entre ellas. - * Se agregó inicio de sesión con Google OAuth - * Se añadió la capacidad de agregar una nueva implementación desde la configuración del dashboard. + * Se agregó la opción de cambiar el dominio personalizado a /docs directamente desde la configuración del dashboard. + * Se unificaron las páginas de inicio de sesión y registro para reducir fricción y confusión. + * Se implementó el flujo de inicio de sesión por descubrimiento para que los usuarios que son miembros de múltiples organizaciones puedan alternar entre ellas. + * Se añadió inicio de sesión con Google OAuth. + * Se añadió la opción de crear una nueva implementación desde la configuración del dashboard. ## Correcciones de errores - * Ahora se pueden usar barras iniciales en navigation. - * Ahora se pueden editar archivos CSS y JS en el editor web. + * Ya se pueden usar barras iniciales en navigation. + * Ya se pueden editar archivos CSS y JS en el editor web. * Se corrigió que `suggestEdit` no apareciera incluso cuando estaba habilitado. - * Se corrigió la navegación por teclado para Search y Chat, de modo que ahora puedes usar las teclas de flecha arriba y abajo para navegar por los resultados. + * Se corrigió la navegación por teclado para Search y Chat, de modo que ahora puedes usar las teclas de flecha arriba y abajo para recorrer los resultados. * No permitir que los motores de búsqueda rastreen páginas protegidas por autenticación de usuario. * Revalidar la caché cuando se elimina una organización. - * Ahora usamos el analizador Scalar OpenAPI para procesar definiciones de OpenAPI, lo cual mejora el rendimiento, corrige problemas de parsing y muestra mejores mensajes de error. + * Ahora usamos el analizador Scalar OpenAPI para interpretar definiciones de OpenAPI, lo que mejora el rendimiento, corrige problemas de análisis y muestra mejores mensajes de error. * Las descripciones de nivel superior ahora son compatibles en las páginas de referencia de API autogeneradas a partir de definiciones de OpenAPI. - * Agregada compatibilidad con estilo en línea para icons - * Se corrigió el “pop-in” de CSS personalizado en la documentación. - * Mostrar correctamente el estilo de código en línea junto con enlaces. + * Agregar compatibilidad con estilo en línea para iconos. + * Se corrigió la aparición repentina del CSS personalizado en la documentación. + * Mostrar correctamente el estilo de código en línea junto con los enlaces. * Mantener la posición de desplazamiento cuando haces clic en el botón Atrás del navegador. @@ -612,7 +612,7 @@ noindex: true ## Imágenes en componentes Card - Agrega la propiedad `img` a una tarjeta para mostrar una imagen en la parte superior de la tarjeta. Obtén más información [aquí](/es/components/cards#image-card). + Agrega la propiedad `img` a una card para mostrar una imagen en la parte superior. Obtén más información [aquí](/es/components/cards#image-card). ## Mejoras en la velocidad de actualización @@ -621,8 +621,8 @@ noindex: true Para proyectos grandes (~3,000 archivos), el paso de descarga para las actualizaciones de la documentación ahora es - ~440x más rápido: una reducción del 99.8% en el tiempo. En general, las descargas de archivos durante - las actualizaciones ahora son ~5.5x más rápidas: una reducción del 81.8% en el tiempo. + ~440x más rápido: una reducción del tiempo del 99.8%. En general, las descargas de archivos durante + las actualizaciones ahora son ~5.5x más rápidas: una reducción del tiempo del 81.8%. ## Mejoras de SEO @@ -630,25 +630,25 @@ noindex: true ![Mejoras de SEO](/images/changelog/seo-improvements.jpeg) - Hemos corregido el diseño tanto móvil como de escritorio de nuestra documentación para que sea más compatible con SEO, incluido añadir las etiquetas aria adecuadas a la barra de navegación y a los elementos de alternancia. + Hemos corregido el diseño móvil y de escritorio de nuestra documentación para que sea más compatible con SEO, incluida la adición de etiquetas aria adecuadas a la barra de navegación y a los elementos de alternancia. ## Mejoras del dashboard - * Migración a App Router en el dashboard. - * La analítica de búsqueda ahora está disponible en el dashboard. + * Migración a app router en el dashboard. + * Las analíticas de búsqueda ahora están disponibles en el dashboard. * Se añadió la funcionalidad para eliminar una organización en el dashboard. * Se publicó la interfaz de conexión con GitLab. * Corrección de datos de Analytics incorrectos. - * Los complementos ahora pueden comprarse directamente a través del dashboard. + * Los complementos ahora se pueden comprar directamente desde el dashboard. ## Correcciones de errores - * Se corrigió un error por el cual la barra superior no se expandía al width de la pantalla cuando estaba en modo personalizado y el diseño de la barra lateral era `sidenav`. + * Se corrigió un error por el que la barra superior no se extendía al width de la pantalla cuando estaba en modo personalizado y el diseño de la barra lateral era `sidenav`. * Corrección del posicionamiento relativo del widget de IA. ## Más - * Solución de problemas para páginas de API: las páginas de API pueden ser complicadas, por lo que enumeramos + * **Solución de problemas para páginas de API**: Las páginas de API pueden ser complicadas, así que enumeramos problemas comunes para ayudarte a resolverlos rápidamente — [Lee la documentación](/es/api-playground/troubleshooting) @@ -662,18 +662,18 @@ noindex: true [additionalProperties](https://swagger.io/docs/specification/data-models/dictionaries/) en las páginas de OpenAPI. - ## Cargas de archivos en el área de pruebas de la API + ## Carga de archivos en el área de pruebas de la API De forma predeterminada, las solicitudes del área de pruebas de la API se enrutan mediante proxy por Mintlify. Ahora puedes usar `disableProxy` para desactivar este comportamiento y admitir tipos de solicitud como - cargas de archivos. + la carga de archivos. * [Más información sobre configuraciones de API](es/settings#api-configurations) - ## Mejoras de SEO en móvil + ## Mejoras de SEO en móviles Hemos corregido el diseño móvil de nuestra documentación para que sea más compatible con SEO, - incluido añadir etiquetas aria adecuadas a los elementos. + incluida la adición de etiquetas aria adecuadas a los elementos. ## Formulario de soporte @@ -685,7 +685,7 @@ noindex: true * Se corrigió un error en la funcionalidad de la integración con Segment. * Ahora mostramos mensajes de error más granulares para permisos de GitHub al interactuar con el editor. - * Se corrigieron errores donde la navigation no se expandía correctamente cuando se usaba un enlace directo. + * Se corrigieron errores por los que la navigation no se expandía correctamente cuando se usaba un enlace directo. @@ -704,29 +704,29 @@ noindex: true ## Plan Pro - También actualizamos nuestros planes de precios para una mejor personalización y escalabilidad. + También actualizamos nuestros planes de precios para lograr mayor personalización y escalabilidad. * [Lee el anuncio en el blog](https://mintlify.com/blog/pro-plan) ## Sincronización de ejemplos de código del área de pruebas de la API - Al navegar por la documentación de la API, el ejemplo de código seleccionado ahora se sincroniza entre tus páginas. + Cuando navegas por la documentación de la API, el ejemplo de código seleccionado ahora se sincroniza en tus páginas. ## Insights - Actualmente en beta, esta función resume preguntas y patrones comunes de usuarios + Actualmente en beta, esta función resume preguntas y patrones comunes de los usuarios en informes fáciles de digerir con sugerencias impulsadas por IA sobre cómo mejorar tu producto. - ## Aspectos destacados de la Launch Week + ## Lo más destacado de la Launch Week - * Temas: personaliza el estilo con temas preconfigurados. Solo agrega el tema Quill, Prism o Venus a tu archivo `docs.json` y se actualizará el estilo de tu documentación. - * Búsqueda V2: consulta directamente las descripciones y los títulos de endpoints de OpenAPI para llegar a las páginas de Referencia de la API, elimina las páginas ocultas de los resultados y disfruta de nuestra barra de búsqueda renovada. + * Temas: Personaliza el estilo con temas preconfigurados. Solo agrega el tema Quill, Prism o Venus a tu archivo `docs.json` y se actualizará el estilo de tu documentación. + * Search V2: consulta directamente las descripciones y los títulos de los endpoints de OpenAPI para llegar a las páginas de Referencia de la API, elimina páginas ocultas de la búsqueda y disfruta de nuestra barra de búsqueda actualizada. * Ramificación en el editor web: crea branches en nuestro editor web sin un IDE. - * Personalización de usuarios: autentica a los usuarios con Shared Session o JWT (JSON Web Token) para mostrarles contenido personalizado, como rellenar previamente claves de API o mostrar contenido específico para clientes. - * Mejoras en la automatización de OpenAPI: para autocompletar páginas del área de pruebas de la API, puedes agregar un campo `openapi` a un objeto en los arrays tabs o anchors en el `docs.json`. + * Personalización del usuario: autentica a los usuarios con Shared Session o JWT (JSON Web Token) para mostrarles contenido personalizado, como rellenar previamente API keys o mostrar contenido específico para clientes. + * Mejoras de automatización de OpenAPI: para completar automáticamente las páginas del área de pruebas de la API, puedes agregar un campo `openapi` a un objeto en los arrays tabs o anchors en el `docs.json`. @@ -734,7 +734,7 @@ noindex: true Ahora admitimos inicio de sesión mediante Okta SAML y OIDC. - ## API REST de Mintlify + ## Mintlify REST API Activa actualizaciones de tu documentación de forma programática. @@ -745,33 +745,33 @@ noindex: true Agrega una configuración al metadata para eliminar todos los elementos excepto la barra superior. Casos de uso de ejemplo: - * Crea una página de inicio global personalizada con componentes personalizados + * Crea una página de destino global personalizada con componentes personalizados * Agrega videos a pantalla completa o galerías de imágenes - * Inserta elementos de demostración iFrame personalizados para agregar interactividad a tu documentación + * Inserta elementos de demostración iFrame personalizados para añadir interactividad a tu documentación - Consulta nuestra [documentación de Modo personalizado](es/pages#custom-mode). + Consulta nuestra [documentación de Custom Mode](es/pages#custom-mode). ## Mintlify MDX para VSCode - Inserta fragmentos de nuestros componentes precompilados y avisos sin salir de VSCode. [Instala la extensión aquí](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets). + Inserta fragmentos de nuestros componentes y avisos prediseñados sin salir de VSCode. [Instala la extensión aquí](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets). ## Mejoras de calidad - * Mejoras del dashboard: visualiza los registros de actualizaciones para ver qué cambió y el estado de una actualización; alterna entre proyectos de Mintlify para gestionar implementaciones - * Versionado con Tabs totalmente compatible + * Mejoras del dashboard: visualiza registros de actualización para ver qué cambió y el estado de una actualización; alterna entre proyectos de Mintlify para gestionar implementaciones + * Versionado con pestañas totalmente compatible * Redirecciones wildcard ahora compatibles - * Detección de errores en la CLI: ahora mostramos la posición del frontmatter inválido cuando hay problemas de análisis durante el desarrollo local + * Detección de errores en la CLI: ahora mostramos la posición del frontmatter no válido cuando hay problemas de análisis durante el desarrollo local - ## Aspectos destacados de la Launch Week + ## Lo más destacado de la Launch Week - * Implementaciones de vista previa: cuando crees una solicitud de extracción, generaremos un enlace único que muestra una vista previa en vivo de cómo se ve tu documentación en producción. Puedes compartir este enlace con tu equipo. + * Implementaciones de vista previa: cuando creas una solicitud de extracción, generaremos un enlace único que muestra una vista previa en vivo de cómo se ve tu documentación en producción. Puedes compartir este enlace con tus compañeros. * Snippets V2: ahora admitimos componentes y variables totalmente reutilizables para snippets. - * Motor MDX de código abierto: expusimos dos APIs —getCompiledMdx y MDXComponent— para que puedas acceder a Markdown de Mintlify y al resaltado de sintaxis de código. [Se aceptan contribuciones al proyecto](https://github.com/mintlify/mdx). - * Información de AI Chat: segmenta el historial de chat por fecha y aumenta la cuota de AI Chat desde el dashboard, y ve con qué frecuencia aparece una búsqueda específica. + * Motor MDX de código abierto: hemos expuesto dos APIs—getCompiledMdx y MDXComponent—para que puedas acceder al Markdown de Mintlify y al resaltado de sintaxis de código. [Las contribuciones al proyecto](https://github.com/mintlify/mdx) son bienvenidas. + * Insights de chat con IA: segmenta el historial de chat por fecha, aumenta la cuota de chat con IA desde el dashboard y consulta con qué frecuencia aparece una búsqueda específica. \ No newline at end of file diff --git a/es/code.mdx b/es/code.mdx index 3884787fe..cf2b48e5c 100644 --- a/es/code.mdx +++ b/es/code.mdx @@ -1,14 +1,14 @@ --- title: "Código" -description: "Mostrar código en línea y bloques de código" +description: "Muestra código en línea y bloques de código" icon: "code" ---
- ## Añadir ejemplos de código + ## Agregar ejemplos de código
-Puedes añadir fragmentos de código en línea o bloques de código. Los bloques de código admiten opciones meta para el resaltado de sintaxis, títulos, resaltado de líneas, icon y más. +Puedes agregar fragmentos de código en línea o bloques de código. Los bloques de código admiten opciones meta para el resaltado de sintaxis, títulos, resaltado de líneas, icon y más.
### Código en línea @@ -24,9 +24,9 @@ Para marcar una `palabra` o `frase` como código, enciérrala entre comillas inv ### Bloques de código
-Usa [bloques de código delimitados](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) encerrando el código entre tres comillas invertidas. Los bloques de código se pueden copiar y, si tienes el assistant habilitado, los usuarios pueden pedir a la IA que explique el código. +Usa [bloques de código con cercas](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) encerrando el código entre tres comillas invertidas (backticks). Los bloques de código se pueden copiar y, si tienes el assistant habilitado, los usuarios pueden pedirle a la IA que explique el código. -Especifica el lenguaje de programación para el resaltado de sintaxis y para habilitar opciones meta. Agrega cualquier opción meta, como un title o icon, después del lenguaje. +Especifica el lenguaje de programación para el resaltado de sintaxis y para habilitar opciones meta. Agrega cualquier opción meta, como un Título o icon, después del lenguaje. ```java HelloWorld.java lines icon="java" class HelloWorld { @@ -47,7 +47,7 @@ class HelloWorld { ````
- ## Opciones del bloque de código + ## Opciones de bloque de código
Puedes añadir opciones de metadatos a tus bloques de código para personalizar su apariencia. @@ -57,7 +57,7 @@ Puedes añadir opciones de metadatos a tus bloques de código para personalizar
- ### Sintaxis de opciones + ### Sintaxis de las opciones
* **Opciones de cadena y booleanas**: Envuélvelas con `""`, `''` o sin comillas. @@ -71,7 +71,7 @@ Activa el resaltado de sintaxis indicando el lenguaje de programación después Usamos [Shiki](https://shiki.style/) para el resaltado de sintaxis y admitimos todos los lenguajes disponibles. Consulta la lista completa de [lenguajes](https://shiki.style/languages) en la documentación de Shiki. -Personaliza globalmente los temas de los bloques de código usando `styling.codeblocks` en tu archivo `docs.json`. Establece temas simples como `system` o `dark`, o configura [temas de Shiki](https://shiki.style/themes) personalizados para los modos claro y oscuro. Consulta [Settings](/es/settings#styling) para ver opciones de configuración detalladas. +Personaliza globalmente los temas de los bloques de código usando `styling.codeblocks` en tu archivo `docs.json`. Establece temas simples como `system` o `dark`, o configura [temas de Shiki](https://shiki.style/themes) personalizados para los modos claro y oscuro. Consulta [Configuración](/es/settings#styling) para ver opciones de configuración detalladas. ```java class HelloWorld { @@ -111,7 +111,7 @@ const hello = "world"; ### Icono
-Agrega un icon a tu bloque de código usando la propiedad `icon`. Consulta [Iconos](/es/components/icons) para ver todas las opciones disponibles. +Agrega un icono a tu bloque de código usando la propiedad `icon`. Consulta [Iconos](/es/components/icons) para ver todas las opciones disponibles. ```javascript icon="square-js" const hello = "mundo"; @@ -127,7 +127,7 @@ const hello = "world"; ### Resaltado de líneas -Resalta líneas específicas en tus bloques de código usando `highlight` con los números o rangos de líneas que quieres resaltar. +Resalta líneas específicas en tus bloques de código usando `highlight` con los números o rangos de líneas que deseas resaltar. ```javascript Line Highlighting Example highlight= {1-2,5} const greeting = "¡Hola, Mundo!"; @@ -151,7 +151,7 @@ sayHello(); ### Enfoque de líneas -Resalta líneas específicas en tus bloques de código usando `focus` con números de línea o rangos. +Enfoca líneas específicas en tus bloques de código usando `focus` con números de línea o rangos. ```javascript Line Focus Example focus= {2,4-5} const greeting = "¡Hola, Mundo!"; @@ -175,7 +175,7 @@ sayHello(); ### Mostrar números de línea -Muestra los números de línea en el lado izquierdo de tu bloque de código usando `lines`. +Muestra los números de línea en el lado izquierdo de tu bloque de código con `lines`. ```javascript Show Line Numbers Example lines const greeting = "¡Hola, Mundo!"; @@ -217,7 +217,7 @@ class Book: class Library: def __init__(self): self.books: Dict[str, Book] = {} - self.checkouts: Dict[str, List[str]] = {} # usuario -> lista de ISBNs + self.checkouts: Dict[str, List[str]] = {} # patron -> list of ISBNs def add_book(self, book: Book) -> None: if book.isbn in self.books: @@ -245,7 +245,7 @@ class Library: def return_book(self, isbn: str) -> float: book = self.books.get(isbn) if not book or not book.checked_out: - raise ValueError("Libro no encontrado o no prestado") + raise ValueError("Libro no encontrado o no está prestado") late_fee = 0.0 if datetime.now() > book.due_date: @@ -255,8 +255,8 @@ class Library: book.checked_out = False book.due_date = None - # Remove from patron's checkouts # Eliminar de los préstamos del usuario + for patron, books in self.checkouts.items(): if isbn in books: books.remove(isbn) break @@ -308,7 +308,7 @@ if __name__ == "__main__": ### Ajuste -Habilita el ajuste de texto para líneas largas usando `wrap`. Esto evita el desplazamiento horizontal y facilita la lectura de las líneas largas. +Activa el ajuste de texto para líneas largas con `wrap`. Esto evita el desplazamiento horizontal y facilita la lectura de líneas extensas. ```javascript Wrap Example wrap const greeting = "¡Hola, Mundo! Soy una línea larga de texto que se ajustará a la siguiente línea."; @@ -332,14 +332,14 @@ sayHello(); ### Diff -Muestra un diff visual de las líneas añadidas o eliminadas en tus bloques de código. Las líneas añadidas se resaltan en verde y las eliminadas se resaltan en rojo. +Muestra un diff visual de las líneas añadidas o eliminadas en tus bloques de código. Las líneas añadidas se resaltan en verde y las eliminadas en rojo. -Para crear diffs, agrega estos comentarios especiales al final de las líneas en tu bloque de código: +Para crear diffs, añade estos comentarios especiales al final de las líneas en tu bloque de código: -* `// [!code ++]`: Marca una línea como añadida (resaltada en verde). -* `// [!code --]`: Marca una línea como eliminada (resaltada en rojo). +* `// [!code ++]`: Marca una línea como añadida (resaltado en verde). +* `// [!code --]`: Marca una línea como eliminada (resaltado en rojo). -Para varias líneas consecutivas, especifica la cantidad de líneas después de dos puntos: +Para varias líneas consecutivas, especifica el número de líneas después de dos puntos: * `// [!code ++:3]`: Marca la línea actual más las dos siguientes como añadidas. * `// [!code --:5]`: Marca la línea actual más las cuatro siguientes como eliminadas. diff --git a/es/components/accordions.mdx b/es/components/accordions.mdx index d3dcf04c9..d9d90c3fb 100644 --- a/es/components/accordions.mdx +++ b/es/components/accordions.mdx @@ -1,12 +1,12 @@ --- -title: "Accordion" -description: "Componentes plegables para mostrar y ocultar contenido" +title: "Accordions" +description: "Componentes desplegables para mostrar u ocultar contenido" icon: "chevron-down" --- import IconsOptional from "/snippets/es/icons-optional.mdx"; -Los Accordion permiten a los usuarios expandir y contraer secciones de contenido. Usa los Accordion para la divulgación progresiva y para organizar la información. +Los Accordions permiten a los usuarios expandir y contraer secciones de contenido. Usa los Accordions para la revelación progresiva y para organizar la información.
@@ -14,7 +14,7 @@ Los Accordion permiten a los usuarios expandir y contraer secciones de contenido
- Puedes colocar cualquier contenido aquí, incluidos otros componentes, como código: + Puedes poner cualquier contenido aquí, incluidos otros componentes, como código: ```java HelloWorld.java class HelloWorld { @@ -44,11 +44,11 @@ Los Accordion permiten a los usuarios expandir y contraer secciones de contenido ## Grupos de Accordion -Agrupa Accordions relacionados usando ``. Esto crea una sección cohesionada de Accordions que se pueden expandir o contraer individualmente. +Agrupa Accordions relacionados con ``. Esto crea una sección coherente de Accordions que se pueden expandir o contraer individualmente. - Puedes colocar otros componentes dentro de los Accordions. + Puedes incluir otros componentes dentro de los Accordions. ```java HelloWorld.java class HelloWorld { @@ -60,7 +60,7 @@ Agrupa Accordions relacionados usando ``. Esto crea una sección - Agrega iconos para que los Accordions sean más distintivos visualmente y fáciles de escanear. + Añade iconos para que los Accordions sean más distintivos visualmente y fáciles de explorar de un vistazo. @@ -102,7 +102,7 @@ Agrupa Accordions relacionados usando ``. Esto crea una sección - Texto debajo del título en la vista previa del Accordion. + Detalle debajo del título en la vista previa del Accordion. diff --git a/es/components/banner.mdx b/es/components/banner.mdx index 1e035195f..47ebfd40d 100644 --- a/es/components/banner.mdx +++ b/es/components/banner.mdx @@ -1,24 +1,24 @@ --- title: "Banner" -description: "Añade un banner para mostrar anuncios y notificaciones importantes en todo el sitio" +description: "Agrega un banner para mostrar anuncios y notificaciones importantes en todo el sitio" icon: "layout-panel-top" --- -Usa banners para mostrar anuncios, actualizaciones o notificaciones importantes en todo tu sitio de documentación. Los banners aparecen en la parte superior de cada página, admiten formato Markdown y se pueden descartar. +Usa banners para mostrar anuncios, actualizaciones o notificaciones importantes en todo tu sitio de documentación. Los banners aparecen en la parte superior de cada página, admiten formato Markdown y se pueden hacer descartables. -Para añadir un banner, usa la propiedad `banner` en tu `docs.json`: +Para agregar un banner, usa la propiedad `banner` en tu `docs.json`: ```json Product announcements wrap "banner": { - "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [cambios](/changelog) para más detalles.", + "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/changelog) para más detalles.", "dismissible": true } ``` ```json Maintenance notices wrap "banner": { - "content": "⚠️ Mantenimiento programado: la API no estará disponible el 15 de diciembre, de 2 a 4 a. m. UTC", + "content": "⚠️ Mantenimiento programado: la API no estará disponible el 15 de diciembre, 2:00–4:00 a. m. UTC", "dismissible": false } ``` @@ -40,5 +40,5 @@ Para añadir un banner, usa la propiedad `banner` en tu `docs.json`: - Indica si los usuarios pueden descartar el banner. Cuando `true`, los usuarios pueden cerrar el banner y no volverá a aparecer durante su sesión. De forma predeterminada, es `false`. + Indica si los usuarios pueden descartar el banner. Cuando es `true`, los usuarios pueden cerrarlo y no volverá a aparecer durante su sesión. De manera predeterminada, es `false`. \ No newline at end of file diff --git a/es/components/callouts.mdx b/es/components/callouts.mdx index cca56049f..8901b75d5 100644 --- a/es/components/callouts.mdx +++ b/es/components/callouts.mdx @@ -1,18 +1,18 @@ --- title: 'Llamadas de atención' -description: 'Usa llamadas de atención para añadir contexto llamativo a tu contenido' +description: 'Usa llamadas de atención para agregar contexto llamativo a tu contenido' icon: 'info' --- -Las llamadas de atención pueden tener estilo de Note, Advertencia, Información, Sugerencia, Check, Peligro o puedes crear tu propia llamada de atención: +Las llamadas de atención pueden tener el estilo de Note, Advertencia, Información, Sugerencia, Check, Danger, o puedes crear tu propia llamada de atención: -Esto añade una nota en el contenido +Esto agrega una nota en el contenido ```mdx Esto agrega una nota en el contenido ``` -Esto muestra una advertencia que debes tener en cuenta +Esto muestra una advertencia a la que debes prestar atención ```mdx Esto genera una advertencia a tener en cuenta @@ -24,25 +24,25 @@ Las llamadas de atención pueden tener estilo de Note, Advertencia, Información Esto resalta información importante ``` -Esto sugiere una Sugerencia útil +Esto muestra una Sugerencia útil ```mdx Esto sugiere una sugerencia útil ``` -Esto nos da un estado marcado +Esto nos devuelve un estado verificado ```mdx Esto nos da un estado marcado ``` -Este es un aviso de alerta +Esta es una nota de advertencia ```mdx Esta es una alerta de peligro ``` - Este es un aviso personalizado + Este es un llamado de atención personalizado ```mdx wrap Esta es una llamada de atención personalizada diff --git a/es/components/cards.mdx b/es/components/cards.mdx index e16e4ea02..627cd112c 100644 --- a/es/components/cards.mdx +++ b/es/components/cards.mdx @@ -1,6 +1,6 @@ --- title: "Tarjetas" -description: "Resalta puntos clave o enlaces con diseños e iconos personalizables" +description: "Destaca puntos clave o enlaces con diseños e iconos personalizables" icon: "square-mouse-pointer" --- @@ -12,8 +12,8 @@ Usa tarjetas para crear contenedores visuales de contenido. Las tarjetas son con ## Tarjeta básica - - Así es como usar una tarjeta con un icono y un enlace. Al hacer clic en esta tarjeta, + + Así se usa una tarjeta con un icono y un enlace. Al hacer clic en esta tarjeta, irás a la página Columns. @@ -34,7 +34,7 @@ Las tarjetas ofrecen varias opciones de diseño y estilo para adaptarse a distin ### Diseño horizontal -Añade la propiedad `horizontal` para mostrar tarjetas en un diseño más compacto y horizontal. +Agrega la propiedad `horizontal` para mostrar tarjetas en un diseño horizontal más compacto. Este es un ejemplo de una tarjeta horizontal. @@ -50,7 +50,7 @@ Añade la propiedad `horizontal` para mostrar tarjetas en un diseño más compac ### Tarjetas con imagen -Añade la propiedad `img` para mostrar una imagen en la parte superior de la tarjeta. +Agrega la propiedad `img` para mostrar una imagen en la parte superior de la tarjeta. Este es un ejemplo de una tarjeta con imagen. @@ -116,13 +116,13 @@ Usa el [componente Columns](/es/components/columns) para organizar varias tarjet - El título que se muestra en la tarjeta. + El título que se muestra en la tarjeta - Color del icono en formato hexadecimal (por ejemplo, `#FF6B6B`). + Color del icon como código hexadecimal (por ejemplo, `#FF6B6B`). @@ -134,13 +134,13 @@ Usa el [componente Columns](/es/components/columns) para organizar varias tarjet - URL o ruta local de una imagen mostrada en la parte superior de la tarjeta. + URL o ruta local de una imagen que se muestra en la parte superior de la tarjeta. - Texto personalizado del botón de acción. + Texto personalizado para el botón de acción. - Mostrar u ocultar el icono de flecha del enlace. + Mostrar u ocultar el icon de flecha del enlace. \ No newline at end of file diff --git a/es/components/code-groups.mdx b/es/components/code-groups.mdx index f3ba1f93f..c02e9a89e 100644 --- a/es/components/code-groups.mdx +++ b/es/components/code-groups.mdx @@ -4,7 +4,7 @@ description: "Muestra varios ejemplos de código en un solo componente" icon: "group" --- -Usa el componente `CodeGroup` para mostrar varios bloques de código en una interfaz con Tabs, lo que permite a los usuarios comparar implementaciones en diferentes lenguajes de programación o ver enfoques alternativos para la misma tarea. +Usa el componente `CodeGroup` para mostrar varios bloques de código en una interfaz con Tabs, lo que permite a los usuarios comparar implementaciones en distintos lenguajes de programación o ver enfoques alternativos para la misma tarea. ```javascript helloWorld.js @@ -30,7 +30,7 @@ Los grupos de código heredan los estilos globales de tu archivo `docs.json`. Pe ## Creación de grupos de código -Para crear un grupo de código, envuelve varios bloques de código con etiquetas ``. Cada bloque de código debe incluir un Título, que será el label de la Tab. +Para crear un grupo de código, envuelve varios bloques de código con etiquetas ``. Cada bloque de código debe incluir un título, que se convertirá en la etiqueta de la Tab. ````mdx @@ -55,10 +55,10 @@ class HelloWorld { ````
- ## Desplegable de idioma + ## Menú desplegable de idiomas
-Puedes reemplazar las pestañas en un grupo de código por un menú desplegable para cambiar entre idiomas usando la prop `dropdown`. +Puedes sustituir las pestañas de un grupo de código por un menú desplegable para cambiar entre idiomas usando la prop `dropdown`. ```javascript helloWorld.js diff --git a/es/components/columns.mdx b/es/components/columns.mdx index 1ccf3c8f2..d420e3cb3 100644 --- a/es/components/columns.mdx +++ b/es/components/columns.mdx @@ -1,11 +1,11 @@ --- title: 'Columnas' -description: 'Muestra tarjetas en paralelo en un formato de cuadrícula' +description: 'Muestra tarjetas una al lado de la otra en un formato de cuadrícula' icon: 'columns-2' -keywords: ['card groups'] +keywords: ['grupos de tarjetas'] --- -El componente `Columns` te permite agrupar varios componentes `Card`. Se usa con más frecuencia para organizar tarjetas en una cuadrícula, especificando el número de columnas. +El componente `Columns` te permite agrupar varios componentes `Card`. Se usa principalmente para colocar tarjetas en una cuadrícula, especificando el número de columnas. diff --git a/es/components/examples.mdx b/es/components/examples.mdx index 614f17c68..f0c936287 100644 --- a/es/components/examples.mdx +++ b/es/components/examples.mdx @@ -11,9 +11,9 @@ Casos de uso comunes: * Documentación de endpoints de API con ejemplos de solicitud y respuesta * Ejemplos de configuración junto con texto explicativo * Fragmentos de código que los usuarios consultan mientras siguen instrucciones -* Ejemplos de antes y después en tutoriales +* Ejemplos de “antes y después” en tutoriales -En dispositivos móviles, los componentes `` y `` se muestran como bloques de código normales y se pueden desplazarse. +En dispositivos móviles, los componentes `` y `` se muestran como bloques de código “regular” y se pueden omitir al desplazarse. ```bash Request @@ -32,7 +32,7 @@ En dispositivos móviles, los componentes `` y ` -Usa `` para fijar ejemplos de código en la barra lateral derecha. Este componente funciona de forma similar a [CodeGroup](/es/components/code-groups), pero muestra el código en la barra lateral en lugar de en línea. +Usa `` para anclar ejemplos de código en la barra lateral derecha. Este componente funciona de forma similar al componente [CodeGroup](/es/components/code-groups), pero muestra el código en la barra lateral en lugar de en línea. Puedes incluir varios bloques de código dentro de un solo ``. Cada bloque de código debe tener un atributo title. @@ -51,7 +51,7 @@ Puedes incluir varios bloques de código dentro de un solo ``. C ## ResponseExample -El componente `` ancla ejemplos de código en la barra lateral derecha, debajo de cualquier contenido de `` en la misma página. +El componente `` ancla ejemplos de código en la barra lateral derecha, debajo de cualquier contenido `` en la misma página. ````mdx ResponseExample diff --git a/es/components/expandables.mdx b/es/components/expandables.mdx index 945e2f4b8..06255a564 100644 --- a/es/components/expandables.mdx +++ b/es/components/expandables.mdx @@ -1,10 +1,10 @@ --- -title: "Secciones desplegables" -description: "Alterna para mostrar propiedades anidadas" +title: "Expandables" +description: "Alternar para mostrar propiedades anidadas" icon: "list-tree" --- -Usa secciones desplegables para mostrar y ocultar contenido anidado dentro de campos de respuesta. Son especialmente útiles para mostrar propiedades de objetos complejos en la documentación de la API. +Usa expandables para mostrar u ocultar contenido anidado dentro de los campos de respuesta. Los expandables son especialmente útiles para mostrar propiedades de objetos complejos en la documentación de la API. @@ -13,7 +13,7 @@ Usa secciones desplegables para mostrar y ocultar contenido anidado dentro de ca - Indica si el usuario es mayor de 21 años + Si el usuario tiene más de 21 años @@ -38,9 +38,9 @@ Usa secciones desplegables para mostrar y ocultar contenido anidado dentro de ca - El nombre del objeto que se muestra. + El nombre del objeto que se está mostrando. - Establécelo en `true` para que el elemento expandible se abra al cargar la página. + Configúralo en `true` para que el elemento expandible se abra al cargar la página. diff --git a/es/components/fields.mdx b/es/components/fields.mdx index f65d36f5b..b4a7f3852 100644 --- a/es/components/fields.mdx +++ b/es/components/fields.mdx @@ -4,7 +4,7 @@ description: "Configura parámetros para tus referencias de API o SDK" icon: "letter-text" --- -Utiliza campos para documentar parámetros y respuestas de la API. Hay dos tipos de campos: de parámetro y de respuesta. +Usa campos para documentar los parámetros y las respuestas de tu API. Hay dos tipos de campos: campos de parámetros y campos de respuestas.
## Campo de parámetro @@ -27,7 +27,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD
- Indica si el parámetro es de búsqueda, ruta, cuerpo o encabezado. A continuación, el + Indica si el parámetro es de tipo query, ruta, cuerpo o encabezado. Seguido del nombre del parámetro. @@ -36,7 +36,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD Admite `number`, `string`, `boolean`, `object`. - Los arreglos se pueden definir usando el sufijo `[]`. Por ejemplo, `string[]`. + Los arrays se pueden definir con el sufijo `[]`. Por ejemplo, `string[]`. @@ -52,7 +52,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD - Texto del marcador de posición para la entrada en el entorno de pruebas. + Texto del marcador de posición para el campo en el playground. @@ -66,7 +66,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD El componente `` define los valores de retorno de una API. - Un ejemplo de campo de respuesta + Ejemplo de un campo de respuesta ```mdx @@ -88,11 +88,11 @@ El componente `` define los valores de retorno de una API. - El valor predeterminado. + Valor predeterminado. - Indica si el campo de la respuesta es obligatorio. + Indica si la respuesta es obligatoria. diff --git a/es/components/files.mdx b/es/components/files.mdx index e469198bf..069f2e4f6 100644 --- a/es/components/files.mdx +++ b/es/components/files.mdx @@ -1,14 +1,14 @@ --- -title: "Files" -description: "Sirve archivos estáticos desde tu documentación" +title: "Archivos" +description: "Sirve recursos estáticos desde tu documentación" icon: "folder" --- -Mintlify sirve automáticamente archivos estáticos desde el repositorio de tu documentación en la ruta adecuada de tu domain. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`. +Mintlify sirve automáticamente recursos estáticos desde tu repositorio de documentación en la ruta correspondiente de tu domain. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`. Esto funciona para cualquier tipo de archivo que quieras poner a disposición de tus usuarios, incluidos imágenes, PDF, videos o esquemas. -Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipos de archivo. +Los archivos deben pesar menos de 20 MB para imágenes y 100 MB para otros tipos de archivo.
## Organización de archivos @@ -28,4 +28,4 @@ Organiza tus archivos en carpetas para que tu repositorio sea fácil de navegar: |- demo-video.mp4 ``` -Los archivos se sirven desde la raíz de tu domain, por lo que la estructura de tu repositorio se corresponde directamente con la estructura de la URL. En el ejemplo anterior, `assets/whitepaper.pdf` estaría disponible en `https://docs.your-project.com/assets/whitepaper.pdf`. +Los archivos se sirven desde la raíz de tu domain, por lo que la estructura de tu repositorio se corresponde directamente con la estructura de la URL. Siguiendo el ejemplo anterior, `assets/whitepaper.pdf` estaría disponible en `https://docs.your-project.com/assets/whitepaper.pdf`. diff --git a/es/components/frames.mdx b/es/components/frames.mdx index 9975e3716..a75403ab8 100644 --- a/es/components/frames.mdx +++ b/es/components/frames.mdx @@ -4,14 +4,14 @@ description: "Envuelve imágenes u otros componentes en un contenedor" icon: "frame" --- -Usa Frames para mostrar imágenes, diagramas u otros contenidos visuales con un estilo uniforme y subtítulos opcionales. Los Frames centran el contenido y lo separan visualmente del texto de alrededor. +Usa frames para mostrar imágenes, diagramas u otro contenido visual con un estilo uniforme y subtítulos opcionales. Los frames centran el contenido y proporcionan separación visual del texto circundante. - Fotografía de un lago rodeado de árboles, con montañas a lo lejos, en el Parque Nacional de Yellowstone. + Fotografía de un lago rodeado de árboles, con montañas a lo lejos en el Parque Nacional de Yellowstone.
- ## Leyendas + ## Subtítulos
Puedes añadir contexto adicional a una imagen usando la prop opcional `caption`. @@ -25,7 +25,7 @@ Puedes añadir contexto adicional a una imagen usando la prop opcional `caption`
- Texto opcional de leyenda que se muestra centrado debajo de tu componente. + Texto opcional de la leyenda que se muestra centrado debajo de tu componente. diff --git a/es/components/icons.mdx b/es/components/icons.mdx index a6da1aaf3..0e2dabc93 100644 --- a/es/components/icons.mdx +++ b/es/components/icons.mdx @@ -1,6 +1,6 @@ --- title: "Iconos" -description: "Usa iconos de bibliotecas de iconos populares" +description: "Utiliza iconos de bibliotecas de iconos populares" icon: "flag" --- @@ -19,9 +19,9 @@ Usa iconos de Font Awesome, Lucide, SVG (Scalable Vector Graphics), URL externas ## Iconos en línea -Los iconos se muestran en línea cuando se utilizan dentro de un párrafo. +Los iconos se colocan en línea cuando se utilizan dentro de un párrafo. - La documentación que quieres, sin esfuerzo. + La documentación que quieres, sin complicaciones. ```markdown Inline icon example La documentación que necesitas, sin complicaciones. @@ -35,7 +35,7 @@ Los iconos se muestran en línea cuando se utilizan dentro de un párrafo. - El color del icon como código hexadecimal (por ejemplo, `#FF5733`). + El color del icon en formato hexadecimal (por ejemplo, `#FF5733`). diff --git a/es/components/mermaid-diagrams.mdx b/es/components/mermaid-diagrams.mdx index 841e2b41f..95da2ec75 100644 --- a/es/components/mermaid-diagrams.mdx +++ b/es/components/mermaid-diagrams.mdx @@ -4,9 +4,9 @@ description: "Muestra diagramas con Mermaid" icon: "waypoints" --- -[Mermaid](https://mermaid.js.org/) te permite crear diagramas de flujo, de secuencia, de Gantt y otros diagramas usando texto y código. +[Mermaid](https://mermaid.js.org/) te permite crear diagramas de flujo, de secuencia, de Gantt y otros, a partir de texto y código. -Para consultar la lista completa de tipos de diagramas y la sintaxis admitida, visita la [documentación de Mermaid](https://mermaid.js.org/intro/). +Para ver la lista completa de tipos de diagramas compatibles y su sintaxis, consulta la [documentación de Mermaid](https://mermaid.js.org/intro/). ```mermaid flowchart LR diff --git a/es/components/panel.mdx b/es/components/panel.mdx index 02743ca57..036c713c9 100644 --- a/es/components/panel.mdx +++ b/es/components/panel.mdx @@ -6,9 +6,9 @@ icon: 'panel-right' Puedes usar el componente `` para personalizar el panel lateral derecho de una página con cualquier componente que quieras. -Si una página tiene un ``, los componentes [RequestExample](/es/components/examples#request-example) y [ResponseExample](/es/components/examples#response-example) deben estar dentro de ``. +Si una página incluye un ``, los componentes [RequestExample](/es/components/examples#request-example) y [ResponseExample](/es/components/examples#response-example) deben ubicarse dentro de ``. -Los componentes dentro de un `` reemplazarán la tabla de contenido de la página. +Los componentes en un `` sustituirán la tabla de contenidos de la página. ```mdx @@ -17,5 +17,5 @@ Los componentes dentro de un `` reemplazarán la tabla de contenido de la ``` - Fija Información en el panel lateral. O añade cualquier otro componente. + Fija Información en el panel lateral. O agrega cualquier otro componente. diff --git a/es/components/responses.mdx b/es/components/responses.mdx index 7254318b9..6e6adfb7c 100644 --- a/es/components/responses.mdx +++ b/es/components/responses.mdx @@ -3,7 +3,7 @@ title: 'Campos de respuesta' description: 'Mostrar valores de respuesta de la API' --- -El componente `` está diseñado para definir los valores que devuelve una API. Muchos documentos también usan `` en páginas cuando necesitas enumerar los tipos de algo. +El componente `` está diseñado para definir los valores que devuelve una API. Muchos documentos también utilizan `` en páginas cuando necesitas listar los tipos de algo. Un ejemplo de campo de respuesta @@ -33,11 +33,11 @@ El componente `` está diseñado para definir los valores que dev - Mostrar “required” junto al nombre del campo. + Mostrar "required" junto al nombre del campo. - Indica si un campo está en desuso o no. + Indica si un campo está en desuso. @@ -52,7 +52,7 @@ El componente `` está diseñado para definir los valores que dev ```mdx Response Field Example - Ejemplo de campo de respuesta + Un ejemplo de campo de respuesta ``` diff --git a/es/components/steps.mdx b/es/components/steps.mdx index ceb19703f..d47db06db 100644 --- a/es/components/steps.mdx +++ b/es/components/steps.mdx @@ -1,12 +1,12 @@ --- title: "Pasos" -description: "Secuencia el contenido con el componente Steps" +description: "Organiza contenido en secuencia con el componente Steps" icon: "list-todo" --- import IconsOptional from "/snippets/es/icons-optional.mdx"; -Usa pasos para mostrar una serie de acciones o eventos secuenciales. Puedes agregar tantos pasos como necesites. +Usa pasos para mostrar una serie de acciones o eventos en secuencia. Puedes añadir tantos pasos como necesites. @@ -46,17 +46,17 @@ Usa pasos para mostrar una serie de acciones o eventos secuenciales. Puedes agre - El tamaño de los títulos de los pasos. Uno de `p`, `h2` o `h3`. + El tamaño de los títulos de los pasos. Uno de `p`, `h2` y `h3`.
- ## Propiedades individuales del paso + ## Propiedades individuales de cada paso
- El contenido de un paso, ya sea texto sin formato o componentes. + El contenido de un paso, ya sea como texto plano o como componentes. diff --git a/es/components/tabs.mdx b/es/components/tabs.mdx index 42f25ace5..b2b4fb982 100644 --- a/es/components/tabs.mdx +++ b/es/components/tabs.mdx @@ -4,13 +4,13 @@ description: "Alterna el contenido con el componente Tabs" icon: "panel-top" --- -Usa pestañas para organizar el contenido en varios paneles entre los que los usuarios pueden cambiar. Puedes agregar tantas pestañas como necesites e incluir otros componentes dentro de cada Tab. +Usa pestañas para organizar el contenido en varios paneles entre los que las personas pueden alternar. Puedes añadir cualquier número de pestañas e incluir otros componentes dentro de cada una. - - ☝️ Bienvenido al contenido que solo puedes ver dentro de la primera pestaña. + + ☝️ Te damos la bienvenida al contenido que solo puedes ver dentro de la primera pestaña. - Puedes agregar cualquier cantidad de componentes dentro de las pestañas. Por ejemplo, un bloque de código: + Puedes añadir cualquier número de componentes dentro de las pestañas. Por ejemplo, un bloque de código: ```java HelloWorld.java class HelloWorld { @@ -21,14 +21,14 @@ Usa pestañas para organizar el contenido en varios paneles entre los que los us ``` - - ✌️ Aquí tienes contenido que solo aparece en la segunda pestaña. + + ✌️ Aquí tienes contenido que solo está dentro de la segunda pestaña. ¡Esta tiene un icono ! - - 💪 Aquí tienes contenido que solo aparece en la tercera pestaña. + + 💪 Aquí tienes contenido que solo está dentro de la tercera pestaña. @@ -63,7 +63,7 @@ Usa pestañas para organizar el contenido en varios paneles entre los que los us - El title del Tab. Los títulos cortos facilitan la navegación. + El título de la Tab. Los títulos cortos facilitan la navegación. @@ -71,5 +71,5 @@ Usa pestañas para organizar el contenido en varios paneles entre los que los us - Solo para icon de Font Awesome: uno de `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. + Solo para iconos de Font Awesome: uno de `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. diff --git a/es/components/tooltips.mdx b/es/components/tooltips.mdx index 5409c68b3..77b5c4fc0 100644 --- a/es/components/tooltips.mdx +++ b/es/components/tooltips.mdx @@ -1,12 +1,12 @@ --- title: "Tooltips" -description: "Mostrar una definición al pasar el cursor sobre el texto" +description: "Muestra una definición al pasar el cursor sobre el texto" icon: "message-square" --- -Usa los tooltips para proporcionar contexto adicional o definiciones cuando un usuario pasa el cursor sobre un fragmento de texto. Los tooltips pueden incluir enlaces de llamada a la acción opcionales. +Usa tooltips para ofrecer contexto adicional o definiciones cuando una persona pasa el cursor sobre un texto. Los tooltips pueden incluir enlaces de llamada a la acción opcionales. -**Ejemplo**: API La documentación ayuda a los desarrolladores a entender cómo integrar tu servicio. +**Ejemplo**: API La documentación ayuda a los desarrolladores a entender cómo integrarse con tu servicio. ```mdx Tooltip example wrap API La documentación de API ayuda a los desarrolladores a entender cómo integrar con tu servicio. @@ -25,5 +25,5 @@ Usa los tooltips para proporcionar contexto adicional o definiciones cuando un u
- URL del enlace de la llamada a la acción. Obligatorio cuando se utiliza `cta`. + URL del enlace de la llamada a la acción. Obligatorio cuando se usa `cta`. \ No newline at end of file diff --git a/es/components/update.mdx b/es/components/update.mdx index 7568e4c4a..9ef94733b 100644 --- a/es/components/update.mdx +++ b/es/components/update.mdx @@ -1,15 +1,15 @@ --- title: "Update" -description: "Haz un seguimiento de los cambios y las actualizaciones" +description: "Lleva un registro de cambios y actualizaciones" icon: "list-collapse" --- -Usa el componente `Update` para mostrar entradas del registro de cambios, actualizaciones de versión y notas de lanzamiento con un formato uniforme. +Usa el componente `Update` para mostrar entradas del changelog, actualizaciones de versión y notas de lanzamiento con un formato coherente. ## Actualización de ejemplo - Puedes añadir cualquier contenido aquí, como una captura de pantalla, un fragmento de código o una lista de cambios. + Puedes añadir cualquier cosa aquí, como una captura de pantalla, un fragmento de código o una lista de cambios. @@ -19,7 +19,7 @@ Usa el componente `Update` para mostrar entradas del registro de cambios, actual * Diseño adaptable * Ancla para cada actualización - * Entrada de RSS generada para cada actualización + * Entrada del feed RSS generada para cada actualización
@@ -39,7 +39,7 @@ Usa varios componentes `Update` para crear [cambios](/es/guides/changelogs).
- Etiqueta de la actualización. Aparece a la izquierda de la actualización y crea un enlace de anclaje. Las etiquetas deben ser únicas. + label de la actualización. Aparece a la izquierda de la actualización y crea un enlace ancla. Los labels deben ser únicos. @@ -47,5 +47,5 @@ Usa varios componentes `Update` para crear [cambios](/es/guides/changelogs). - Descripción de la actualización. Aparece debajo de la etiqueta y las etiquetas. + Descripción de la actualización. Aparece debajo del label y de la etiqueta. diff --git a/es/contact-support.mdx b/es/contact-support.mdx index 2caf532dc..f0430bac0 100644 --- a/es/contact-support.mdx +++ b/es/contact-support.mdx @@ -1,7 +1,7 @@ --- -title: "Contacta al soporte" +title: "Contactar con el soporte" icon: "circle-help" -description: "Estamos aquí para ayudarte a sacar el máximo partido de Mintlify" +description: "Estamos aquí para ayudarte a sacar el máximo partido a Mintlify" ---
@@ -11,25 +11,25 @@ description: "Estamos aquí para ayudarte a sacar el máximo partido de Mintlify Selecciona Command + I para iniciar un chat con nuestro Asistente de IA entrenado con nuestra documentación.
- ## Mira videos tutoriales + ## Mira tutoriales en video
-Visita nuestro canal de [YouTube](https://www.youtube.com/@GetMintlify/videos) para encontrar tutoriales y guías sobre cómo usar Mintlify. +Visita nuestro canal de [YouTube](https://www.youtube.com/@GetMintlify/videos) para ver tutoriales y guías sobre el uso de Mintlify.
- ## Soporte por mensaje + ## Soporte por mensajes
Envíanos un mensaje desde tu [dashboard](https://dashboard.mintlify.com/) seleccionando **Support** en la barra lateral. -![GIF que muestra cómo acceder al soporte desde el dashboard seleccionando el botón Support, luego eligiendo una opción y escribiendo una pregunta en la ventana modal de soporte que aparece.](https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/support-flow.gif) +![GIF que muestra cómo acceder al soporte desde el dashboard seleccionando el botón Support, luego eligiendo una opción y escribiendo una pregunta en el modal de soporte que aparece.](https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/support-flow.gif) -Nuestro objetivo es responder a todas las solicitudes en un plazo de 24 horas, pero pueden producirse retrasos en periodos de alta demanda. +Nuestro objetivo es responder todas las solicitudes en un plazo de 24 horas, pero pueden producirse retrasos en períodos de alta demanda.
## Soporte por correo electrónico
-Si no puedes acceder al dashboard, escríbenos a support@mintlify.com. \ No newline at end of file +Si no puedes acceder a tu dashboard, escríbenos a support@mintlify.com. \ No newline at end of file diff --git a/es/editor/branches.mdx b/es/editor/branches.mdx index 08ff507be..84dcb1909 100644 --- a/es/editor/branches.mdx +++ b/es/editor/branches.mdx @@ -1,17 +1,17 @@ --- title: "Trabajar con branches" -description: "Usa branches para hacer y revisar cambios sin afectar tu documentación en producción" +description: "Usa branches para realizar y revisar cambios sin afectar tu documentación en producción" --- -Las branches son una función del control de versiones que apuntan a confirmaciones específicas en tu repositorio. Tu rama de implementación, normalmente llamada `main`, representa el contenido que se utiliza para compilar tu documentación en producción. Todas las demás branches son independientes de tu documentación publicada a menos que decidas fusionarlas en tu rama de implementación. +Los branches son una característica del control de versiones que apuntan a confirmaciones específicas en tu repositorio. Tu rama de implementación, normalmente llamada `main`, representa el contenido que se usa para compilar tu documentación en producción. Todos los demás branches son independientes de tu documentación en producción, a menos que decidas fusionarlos en tu rama de implementación. -Las branches te permiten crear instancias separadas de tu documentación para hacer cambios, recibir revisiones y probar nuevos enfoques antes de publicar. Tu equipo puede trabajar en branches para actualizar distintas partes de tu documentación al mismo tiempo sin afectar lo que los usuarios ven en tu sitio en producción hasta que publiques los cambios. +Los branches te permiten crear instancias separadas de tu documentación para hacer cambios, recibir revisiones y probar nuevos enfoques antes de publicar. Tu equipo puede trabajar en branches para actualizar diferentes partes de tu documentación al mismo tiempo sin afectar lo que los usuarios ven en tu sitio en producción hasta que publiques cualquier cambio. Recomendamos trabajar siempre desde branches al actualizar la documentación para mantener estable tu sitio en producción y habilitar flujos de revisión. - - Pon nombres claros a las branches para que tu equipo entienda en qué estás trabajando. - - Elimina las branches después de fusionarlas para mantener tu repositorio organizado. + - Pon nombres claros a los branches para que tu equipo entienda en qué estás trabajando. + - Elimina los branches después de fusionarlos para mantener tu repositorio organizado. - Informa a tu equipo cuando estés trabajando en cambios importantes que puedan afectar su trabajo. @@ -19,9 +19,9 @@ Recomendamos trabajar siempre desde branches al actualizar la documentación par ## Crear una branch
-1. Selecciona el nombre de la branch en la barra de herramientas del editor (por lo general `main` de forma predeterminada). +1. Selecciona el nombre de la branch en la barra de herramientas del editor (normalmente `main` por defecto). 2. Selecciona **New Branch**. -3. Ingresa un nombre descriptivo para tu branch, como `update-getting-started` o `fix-api-examples`. +3. Escribe un nombre descriptivo para tu branch, como `update-getting-started` o `fix-api-examples`. 4. Selecciona **Create Branch**.
diff --git a/es/editor/content-management.mdx b/es/editor/content-management.mdx index ee525c517..192b018ca 100644 --- a/es/editor/content-management.mdx +++ b/es/editor/content-management.mdx @@ -1,5 +1,5 @@ --- -title: "Administrar contenido" +title: "Administración de contenido" description: "Crea, edita y organiza tus páginas de documentación" --- @@ -7,9 +7,9 @@ description: "Crea, edita y organiza tus páginas de documentación" ## Navegar por tus archivos
-Usa el explorador de archivos de la barra lateral para recorrer tus archivos de documentación. Haz clic en cualquier archivo para abrirlo en el editor. +Usa el explorador de archivos de la barra lateral para explorar tus archivos de documentación. Haz clic en cualquier archivo para abrirlo en el editor. -Pulsa Command + P (Ctrl + P en Windows) para buscar archivos por nombre. +Presiona Command + P (Ctrl + P en Windows) para buscar archivos por nombre.
## Crear páginas nuevas @@ -36,7 +36,7 @@ Pulsa Command + P (Ctrl + P en Windo }} alt="Menú de archivos en el editor web en modo oscuro"/> - + Los nombres de archivo deben terminar en `.mdx`. Por ejemplo, `api-reference.mdx` o `getting-started.mdx`. @@ -45,25 +45,25 @@ Pulsa Command + P (Ctrl + P en Windo
- ## Cómo organizar tu navigation + ## Organiza tu navegación
-Agrega nuevas páginas a la navigation de tu sitio editando tu archivo `docs.json`. +Agrega nuevas páginas a la navegación de tu sitio editando tu `docs.json`. - Abre el archivo `docs.json` en tu directorio raíz usando el explorador de archivos. + Busca y abre el archivo `docs.json` en tu directorio raíz usando el explorador de archivos. - Ubica la sección de `navigation` en el archivo `docs.json` donde quieres añadir tu nueva página. + Encuentra el lugar en el archivo `docs.json` donde quieras agregar tu nueva página. - Inserta el nombre de archivo de tu página (sin la extensión `.mdx`) en el array `pages` del grupo correspondiente. + Inserta el nombre de archivo de tu página (sin la extensión `.mdx`) en el arreglo `pages` del grupo correspondiente.
- ### Ejemplo: Agregar una página de temas + ### Ejemplo: Añadir una página de temas
```json title="Adding a themes page to the Profile group" highlight="18" @@ -97,25 +97,25 @@ Agrega nuevas páginas a la navigation de tu sitio editando tu archivo `docs.jso ## Edición de contenido
-Haz cambios en tus páginas usando el modo visual o el Modo Markdown en el editor. +Realiza cambios en tus páginas usando el modo visual o el Modo Markdown en el editor. -En el modo visual, presiona / para abrir el menú de componentes. Añade bloques de contenido, avisos, bloques de código y otros componentes para personalizar tu documentación. +En el modo visual, presiona / para abrir el menú de componentes. Agrega bloques de contenido, avisos, bloques de código y otros componentes para personalizar tu documentación. El menú de componentes desplegado destacado en el editor web de Mintlify El menú de componentes desplegado destacado en el editor web de Mintlify -En el Modo Markdown, puedes editar directamente el `MDX` de tus páginas. Esto es útil cuando necesitas: +En el Modo Markdown, puedes editar directamente el `MDX` de tus páginas. Esto puede ser útil cuando necesitas: - Definir propiedades específicas de componentes - Trabajar con componentes anidados complejos -- Copiar y pegar contenido `MDX` desde otras fuentes \ No newline at end of file +- Copiar y pegar contenido `MDX` de otras fuentes \ No newline at end of file diff --git a/es/editor/getting-started.mdx b/es/editor/getting-started.mdx index 05f5071df..04be3d300 100644 --- a/es/editor/getting-started.mdx +++ b/es/editor/getting-started.mdx @@ -10,10 +10,10 @@ description: "Aprende a crear y editar documentación con el editor web" El editor web es una interfaz visual para crear, editar y revisar documentación directamente en tu navegador. -* **Edición visual**: Realiza cambios en tu documentación con un editor WYSIWYG (what you see is what you get) que muestra cómo se verá tu contenido al publicarlo. +* **Edición visual**: Realiza cambios en tu documentación con un editor WYSIWYG (what you see is what you get) que muestra cómo se verá tu contenido al publicarse. * **Sincronización con Git**: Todos los cambios se sincronizan automáticamente con tu repositorio de Git para mantener el control de versiones. * **Colaboración en equipo**: Varias personas pueden trabajar en la documentación simultáneamente. -* **Integración de componentes**: Agrega Sugerencias, bloques de código y otros componentes con comandos de barra (/). +* **Integración de componentes**: Agrega avisos, bloques de código y otros componentes con comandos de barra inclinada. * **Sin configuración**: Comienza a escribir de inmediato desde tu dashboard.
@@ -28,11 +28,11 @@ Así es como normalmente trabajarás en el editor web: - Navega a un archivo existente en la barra lateral o crea uno nuevo usando el explorador de archivos. + Ve a un archivo existente en la barra lateral o crea uno nuevo usando el explorador de archivos. - Realiza cambios en el editor web. Prueba cambiar entre el modo visual y el Modo Markdown usando el interruptor en la esquina superior derecha para ver qué modo prefieres. + Realiza cambios en el editor web. Prueba alternar entre el modo visual y el Modo Markdown usando el interruptor en la esquina superior derecha para ver qué modo prefieres. @@ -40,7 +40,7 @@ Así es como normalmente trabajarás en el editor web: - Si estás trabajando en tu rama de implementación, publica tus cambios directamente desde el editor web. En otros branch, crearás una solicitud de extracción para revisión antes de publicar. + Si estás trabajando en tu rama de implementación, publica tus cambios directamente desde el editor web. En otros branches, crea una solicitud de extracción para revisión antes de publicar. @@ -48,7 +48,7 @@ Así es como normalmente trabajarás en el editor web: ## Modos del editor
-El editor web tiene dos modos para adaptarse a distintas preferencias y necesidades de edición. Usa el conmutador en la esquina superior derecha de la barra de herramientas del editor para cambiar entre los modos de edición. +El editor web tiene dos modos para adaptarse a distintas preferencias y necesidades de edición. Usa el conmutador en la esquina superior derecha de la barra de herramientas del editor para cambiar entre modos de edición. Iconos del conmutador de modo resaltados en el editor web. @@ -60,9 +60,9 @@ El editor web tiene dos modos para adaptarse a distintas preferencias y necesida ### Modo visual -El modo visual ofrece una experiencia WYSIWYG (what you see is what you get) en la que los cambios que haces en el editor son los que se publicarán en tu sitio de documentación. Este modo es ideal cuando quieres ver en tiempo real cómo se verán tus cambios. +El modo visual ofrece una experiencia WYSIWYG (lo que ves es lo que obtienes) en la que los cambios que haces en el editor son los mismos que se publicarán en tu sitio de documentación. Este modo es ideal cuando quieres ver en tiempo real cómo se verán tus cambios. -Pulsa `/` para abrir el menú de componentes y añadir contenido con estilo, avisos, fragmentos de código u otros componentes. +Pulsa “/” para abrir el menú de componentes y añadir contenido con estilo, avisos, fragmentos de código u otros componentes. Modo de edición visual en el editor web de Mintlify @@ -74,12 +74,12 @@ Pulsa `/` para abrir el menú de componentes y añadir contenido con estilo, avi ### Modo Markdown -El Modo Markdown proporciona acceso directo al código `MDX` subyacente de tu documentación. Este modo es ideal cuando necesitas un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de Markdown. +Markdown mode proporciona acceso directo al código `MDX` subyacente de tu documentación. Este modo es ideal cuando necesitas un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de Markdown. - Modo Markdown en el editor web de Mintlify + Markdown mode en el editor web de Mintlify - Modo Markdown en el editor web de Mintlify + Markdown mode en el editor web de Mintlify
@@ -87,6 +87,6 @@ El Modo Markdown proporciona acceso directo al código `MDX` subyacente de tu do
* Aprende los conceptos fundamentales de [Git](/es/editor/git-concepts). -* Aprende las mejores prácticas para colaborar mediante [branches](/es/editor/branches). +* Aprende las prácticas recomendadas para colaborar con [branches](/es/editor/branches). * Explora la [gestión de contenido](/es/editor/content-management) con el editor web. * Comprende las [opciones de publicación](/es/editor/publishing) para distintos escenarios. \ No newline at end of file diff --git a/es/editor/git-concepts.mdx b/es/editor/git-concepts.mdx index b7474f917..dac21455e 100644 --- a/es/editor/git-concepts.mdx +++ b/es/editor/git-concepts.mdx @@ -3,17 +3,17 @@ title: "Conceptos de Git" description: "Aprende los fundamentos de Git para el flujo de trabajo de documentación como código" --- -Git es un sistema de control de versiones que te permite seguir los cambios en tu documentación y colaborar con los miembros del equipo. Con Git, para cada archivo de tu proyecto, puedes ver qué cambió, cuándo y por qué. Git también facilita volver a versiones anteriores de los archivos si alguna vez lo necesitas. +Git es un sistema de control de versiones que te permite realizar un seguimiento de los cambios en tu documentación y colaborar con los miembros del equipo. Con Git, para cada archivo de tu proyecto puedes ver qué cambió, cuándo y por qué. Git también facilita volver a versiones anteriores de los archivos si alguna vez lo necesitas. -El editor web realiza algunas operaciones de Git en segundo plano. Comprender estos conceptos te ayudará a trabajar de forma más eficaz con el editor web y a colaborar con miembros del equipo que trabajan en sus entornos de desarrollo locales. +El editor web realiza algunas operaciones de Git en segundo plano. Comprender estos conceptos te ayudará a trabajar de forma más eficaz con el editor web y a colaborar con los miembros del equipo que trabajan en sus entornos de desarrollo locales.
- ## Conceptos básicos de Git + ## Conceptos fundamentales de Git
- El origen de tu documentación, donde se almacenan todos los archivos y su historial. El editor web se conecta a tu repositorio para acceder y modificar el contenido. + La fuente de tu documentación, donde se almacenan todos los archivos y su historial. El editor web se conecta a tu repositorio para acceder al contenido y modificarlo. @@ -21,46 +21,46 @@ El editor web realiza algunas operaciones de Git en segundo plano. Comprender es - Una branch apunta a una confirmación específica en tu repositorio. Tu documentación en producción se construye a partir de una rama de implementación. Puedes tener cualquier cantidad de otras branches con cambios que aún no se han publicado en tu documentación en producción. Si quieres incorporar los cambios de una branch en tu documentación en producción, puedes fusionar la branch en tu rama de implementación mediante una solicitud de extracción. + Una branch apunta a una confirmación específica en tu repositorio. Tu documentación en producción se compila a partir de una rama de implementación. Puedes tener cualquier cantidad de otras branches con cambios que aún no se han publicado en tu documentación en producción. Si deseas incorporar los cambios de una branch en tu documentación en producción, puedes fusionarla en tu rama de implementación mediante una solicitud de extracción. - Usa branches para trabajar en cambios sin afectar tu documentación en producción, experimentar de forma segura con nuevas funciones y obtener revisiones antes de publicar. + Usa branches para trabajar en cambios sin afectar tu documentación en producción, experimentar de forma segura con nuevas funcionalidades y obtener revisiones antes de publicar. - La branch principal de tu proyecto desde la cual se construye el contenido de tu documentación en producción. Los cambios en esta branch se publican automáticamente en tu sitio de documentación. A menudo llamada `main`, pero puedes configurar cualquier branch como tu rama de implementación. + La branch principal de tu proyecto desde la cual se compila el contenido de tu documentación en producción. Los cambios en esta branch se publican automáticamente en tu sitio de documentación. A menudo se llama `main`, pero puedes establecer cualquier branch como tu rama de implementación. - Una forma de proponer la fusión de tus cambios en una branch con tu documentación en producción. Permite revisión y discusión antes de que los cambios se publiquen. Comúnmente llamada PR, y también llamada merge request en GitLab. + Una forma de proponer fusionar tus cambios en una branch en tu documentación en producción. Permite revisión y discusión antes de que los cambios se publiquen. Comúnmente llamada PR, y también denominada merge request en GitLab. - Un diff (o diferencia) muestra los cambios entre dos versiones de un archivo. Al revisar solicitudes de extracción, los diffs resaltan lo que se ha agregado, eliminado o modificado, lo que facilita identificar qué cambió. + Un diff (o diferencia) muestra los cambios entre dos versiones de un archivo. Al revisar solicitudes de extracción, los diffs resaltan lo que se agregó, eliminó o modificó, lo que facilita identificar qué cambió.
- ## Cómo el editor web usa Git + ## Cómo utiliza Git el editor web
El editor web se conecta a tu repositorio de Git mediante la [Aplicación de GitHub](/es/settings/github) o la [integración con GitLab](/es/settings/gitlab) y automatiza operaciones comunes de Git. Cuando: -* **Abres un archivo**: el editor obtiene la versión más reciente de tu repositorio, asegurando que siempre trabajes con contenido actualizado. -* **Realizas cambios**: el editor sigue tus cambios como un borrador que puede convertirse en una confirmación cuando estés listo para guardar tu trabajo. -* **Guardas cambios**: el editor crea una confirmación con tus cambios, preservando tu trabajo en el historial del proyecto. -* **Creas una branch**: el editor crea una nueva branch en tu repositorio que puede usar cualquiera con acceso al repositorio para colaborar y revisar cambios. -* **Publicas en tu rama de implementación**: el editor confirma y envía directamente a tu rama de implementación, lo que publica tus cambios de inmediato. -* **Publicas en otras branches**: el editor crea una solicitud de extracción, lo que te permite recibir comentarios de otros antes de fusionar tus cambios en tu rama de implementación. +* **Abres un archivo**: El editor obtiene la versión más reciente de tu repositorio y garantiza que siempre trabajes con contenido actualizado. +* **Realizas cambios**: El editor registra tus cambios como un borrador que puede convertirse en una confirmación cuando estés listo para guardar tu trabajo. +* **Guardar cambios**: El editor realiza una confirmación con tus cambios, preservando tu trabajo en el historial del proyecto. +* **Creas una branch**: El editor crea una nueva branch en tu repositorio que puede ser utilizada por cualquier persona con acceso al repositorio para colaborar y revisar cambios. +* **Publicas en tu rama de implementación**: El editor realiza una confirmación y hace push directamente a tu rama de implementación, lo que publica tus cambios de inmediato. +* **Publicas en otras branches**: El editor crea una solicitud de extracción, lo que te permite recibir comentarios de otras personas antes de fusionar tus cambios en tu rama de implementación.
## Mejores prácticas de Git
-Cada equipo desarrollará sus propios flujos de trabajo y preferencias, pero estas son algunas prácticas recomendadas generales para comenzar. +Cada equipo desarrollará sus propios flujos de trabajo y preferencias, pero estas son algunas prácticas recomendadas generales para empezar. -* **Escribe mensajes de confirmación descriptivos**: Sé específico sobre qué cambió y usa un lenguaje activo. -* **Usa nombres de branch descriptivos**: Los nombres de branch deben explicar el trabajo que se está realizando y ser significativos para quien vea las branches en tu repositorio. -* **Mantén las branches enfocadas**: Limita los cambios en una branch a una tarea o proyecto específico. -* **Elimina las branches después de hacer merge**: Borra las branches cuando ya no las necesites para mantener tu repositorio ordenado. \ No newline at end of file +* **Escribe mensajes de confirmación descriptivos**: Sé específico sobre qué cambió usando un lenguaje activo. +* **Usa nombres de branch descriptivos**: Los nombres de branch deben explicar el trabajo que se está realizando y ser significativos para alguien que esté viendo las branches en tu repositorio. +* **Mantén las branches enfocadas**: Mantén los cambios en una branch enfocados en una tarea o proyecto específicos. +* **Elimina las branches después de hacer merge**: Elimina las branches cuando ya no las necesites para mantener tu repositorio ordenado. \ No newline at end of file diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx index 9ab46cca9..3ce6891a3 100644 --- a/es/editor/keyboard-shortcuts.mdx +++ b/es/editor/keyboard-shortcuts.mdx @@ -22,6 +22,6 @@ El editor web admite todos los atajos de teclado habituales, como copiar, pegar, | **Encabezado 4** | Cmd + Alt + 4 | Control + Alt + 4 | | **Lista numerada** | Cmd + Shift + 7 | Control + Shift + 7 | | **Lista con viñetas** | Cmd + Shift + 8 | Control + Shift + 8 | -| **Cita** | Cmd + Shift + B | Control + Shift + B | +| **Cita en bloque** | Cmd + Shift + B | Control + Shift + B | | **Subíndice** | Cmd + , | Control + , | | **Superíndice** | Cmd + . | Control + . | \ No newline at end of file diff --git a/es/editor/publishing.mdx b/es/editor/publishing.mdx index 524857482..752e875c1 100644 --- a/es/editor/publishing.mdx +++ b/es/editor/publishing.mdx @@ -1,12 +1,12 @@ --- -title: "Publicar tus cambios" +title: "Publicación de tus cambios" description: "Implementa las actualizaciones de tu documentación directamente en producción o mediante solicitudes de extracción" --- -Cómo se publican tus cambios depende de la rama en la que estés trabajando: +La forma en que se publican tus cambios depende de en qué branch estés trabajando: -* **Rama de implementación**: Al publicar, tu sitio en producción se actualiza de inmediato. -* **Otras ramas**: Al publicar, se crea una solicitud de extracción para que puedas revisar los cambios antes de implementarlos en producción. +* **Rama de implementación**: Publicar actualiza tu sitio en producción de inmediato. +* **Otras ramas**: Publicar crea una solicitud de extracción para que puedas revisar los cambios antes de que se implementen en producción. -Las solicitudes de extracción te permiten proponer cambios desde tu branch para que otras personas los revisen antes de incorporarlos a tu documentación en producción. Esto ayuda a garantizar que tus cambios sean correctos y le da a tu equipo la oportunidad de colaborar en el contenido. +Las solicitudes de extracción te permiten proponer cambios desde tu branch para que otras personas los revisen antes de integrarlos en tu documentación en producción. Esto ayuda a asegurar que tus cambios sean correctos y le da a tu equipo la oportunidad de colaborar en el contenido. Incluso si trabajas en solitario, las solicitudes de extracción son útiles para previsualizar cambios y mantener un historial claro de actualizaciones. @@ -37,29 +37,29 @@ Las solicitudes de extracción te permiten proponer cambios desde tu branch para - Asegúrate de que todos tus cambios estén guardados en tu branch usando **Guardar cambios**. + Asegúrate de que todos tus cambios se hayan guardado en tu branch usando **Guardar cambios**. - Selecciona **Publicar solicitud de extracción** en la esquina superior derecha del editor. + Selecciona **Publish Pull Request** en la esquina superior derecha del editor. - + Escribe un título y una descripción claros que expliquen: - - Qué cambios hiciste + - Qué cambios realizaste - Por qué los hiciste - - Qué áreas específicas necesitan revisión + - Cualquier área específica que necesite revisión - Selecciona **Publicar solicitud de extracción**. El editor te proporcionará un enlace para ver tu solicitud de extracción. + Selecciona **Publish Pull Request**. El editor proporcionará un enlace para ver tu solicitud de extracción. Botón Publicar solicitud de extracción resaltado en el editor web de Mintlify Botón Publicar solicitud de extracción resaltado en el editor web de Mintlify @@ -70,10 +70,10 @@ Las solicitudes de extracción te permiten proponer cambios desde tu branch para ## Revisar solicitudes de extracción -Una vez creada tu solicitud de extracción: +Una vez que se crea tu solicitud de extracción: 1. **Revisar cambios**: Tú y los miembros de tu equipo pueden revisar tu solicitud de extracción en tu proveedor de Git, como GitHub o GitLab. 2. **Dejar comentarios**: Agrega comentarios o solicita cambios. -3. **Realizar cambios adicionales**: Realiza cambios adicionales en el editor web. Cuando seleccionas Guardar cambios, el editor los envía a tu solicitud de extracción. -4. **Aprobar**: Aprueba la solicitud de extracción cuando estés satisfecho con los cambios. -5. **Fusionar**: Fusiona la solicitud de extracción cuando estés listo para desplegar tus cambios en producción. \ No newline at end of file +3. **Hacer cambios adicionales**: Realiza cambios adicionales en el editor web. Cuando guardas cambios, el editor los envía a tu solicitud de extracción. +4. **Aprobar**: Aprueba la solicitud de extracción cuando estés conforme con los cambios. +5. **Fusionar**: Fusiona la solicitud de extracción cuando estés listo para implementar tus cambios en producción. \ No newline at end of file diff --git a/es/editor/troubleshooting.mdx b/es/editor/troubleshooting.mdx index 78ca7a2ec..0c2dfabb6 100644 --- a/es/editor/troubleshooting.mdx +++ b/es/editor/troubleshooting.mdx @@ -4,21 +4,21 @@ sidebarTitle: "Solución de problemas" description: "Soluciones a problemas comunes" --- -Encuentra soluciones a problemas comunes que podrías encontrar al usar el editor web. +Encuentra soluciones a problemas comunes que puedes encontrar al usar el editor web. **Posibles causas:** - * La implementación aún está en progreso + * La implementación aún está en curso * Problemas de caché del navegador * Errores de compilación o implementación **Soluciones:** - 1. Verifica el estado de la implementación en tu dashboard. - 2. Fuerza la recarga del navegador (Ctrl + F5 o Cmd + Shift + R) - 3. Borra la caché del navegador. + 1. Revisa el estado de la implementación en tu dashboard. + 2. Actualiza forzosamente tu navegador (Ctrl + F5 o Cmd + Shift + R) + 3. Borra la caché de tu navegador. @@ -29,8 +29,8 @@ Encuentra soluciones a problemas comunes que podrías encontrar al usar el edito **Soluciones:** - 1. Verifica que tengas el acceso correcto al repositorio. - 2. Comprueba que tu integración de Git esté correctamente configurada. + 1. Verifica que tienes el acceso adecuado al repositorio. + 2. Comprueba si tu integración de Git está configurada correctamente. 3. Revisa la documentación de [Permisos del editor](/es/advanced/dashboard/permissions). @@ -50,13 +50,13 @@ Encuentra soluciones a problemas comunes que podrías encontrar al usar el edito **Posibles causas:** - * Sintaxis MDX no válida en los archivos + * Sintaxis MDX inválida en los archivos * Archivos faltantes o dañados - * Archivos de gran tamaño que causan tiempos de espera + * Archivos de gran tamaño que provocan timeouts **Soluciones:** - 1. Revisa la sintaxis del archivo para detectar errores de formato MDX. + 1. Revisa la sintaxis del archivo en busca de errores de formato de MDX. 2. Verifica que el archivo exista en tu repositorio. \ No newline at end of file diff --git a/es/guides/assistant.mdx b/es/guides/assistant.mdx index feec814dd..97f6e6d31 100644 --- a/es/guides/assistant.mdx +++ b/es/guides/assistant.mdx @@ -1,6 +1,6 @@ --- title: "Assistant" -description: "Ayuda a tus usuarios a tener éxito con tu producto y a encontrar respuestas más rápido" +description: "Ayuda a los usuarios a tener éxito con tu producto y a encontrar respuestas más rápido" icon: "bot" --- @@ -12,15 +12,15 @@ icon: "bot" ## Acerca del assistant -El assistant responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Está integrado directamente en tu sitio de documentación, lo que brinda a los usuarios acceso inmediato a ayuda contextual. +El assistant responde preguntas sobre tu documentación mediante consultas en lenguaje natural. Está integrado directamente en tu sitio de documentación, ofreciendo a los usuarios acceso inmediato a ayuda contextual. -El assistant utiliza RAG agéntico (generación aumentada por recuperación) con llamadas a herramientas impulsadas por Claude Sonnet 4. Cuando los usuarios hacen preguntas, el assistant: +El assistant utiliza RAG agente (generación aumentada por recuperación) con llamadas a herramientas impulsadas por Claude Sonnet 4. Cuando los usuarios hacen preguntas, el assistant: * **Busca y recupera** contenido relevante de tu documentación para ofrecer respuestas precisas. -* **Cita las fuentes** y proporciona enlaces navegables que llevan a los usuarios directamente a las páginas de referencia. -* **Genera ejemplos de código para copiar** que ayudan a los usuarios a implementar soluciones de tu documentación. +* **Cita las fuentes** y proporciona enlaces navegables que llevan a los usuarios directamente a las páginas referenciadas. +* **Genera ejemplos de código que se pueden copiar** para ayudar a los usuarios a implementar soluciones a partir de tu documentación. -Cada mensaje enviado al assistant cuenta para la asignación de mensajes de tu plan. Si superas tu asignación, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el assistant si alcanzas tu asignación de mensajes. +Cada mensaje enviado al assistant cuenta para el límite de mensajes de tu plan. Si superas ese límite, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el assistant cuando alcances tu límite de mensajes. Puedes ver el uso del assistant desde tu dashboard para comprender el comportamiento de los usuarios y la efectividad de la documentación. Exporta y analiza los datos de búsqueda para ayudar a identificar: @@ -29,32 +29,32 @@ Puedes ver el uso del assistant desde tu dashboard para comprender el comportami * Temas populares que podrían beneficiarse de contenido adicional.
- ## Configurar el assistant + ## Configuración del assistant
-El assistant está habilitado de forma predeterminada para los planes Pro y Custom. Puedes gestionarlo desde tu [dashboard](https://dashboard.mintlify.com/products/assistant/settings), incluida su activación o desactivación, la configuración del manejo de respuestas y el establecimiento de un límite de gasto. +El assistant está habilitado de forma predeterminada para los planes Pro y Custom. Puedes administrar el assistant desde tu [dashboard](https://dashboard.mintlify.com/products/assistant/settings), incluyendo habilitarlo o deshabilitarlo, configurar el manejo de respuestas y establecer un límite de gasto.
### Estado del assistant
-Activa o desactiva el assistant para habilitarlo o deshabilitarlo en tu sitio de documentación. +Alterna el estado del assistant para habilitarlo o deshabilitarlo en tu sitio de documentación.
### Desvío del assistant
-Permite que el assistant redirija las preguntas sin respuesta a tu equipo de soporte. Proporciona una dirección de correo electrónico que el assistant entregará a los usuarios que hagan preguntas que no pueda responder. +Permite que el assistant redirija las preguntas sin respuesta a tu equipo de soporte. Proporciona una dirección de correo electrónico que el assistant dará a los usuarios que hagan preguntas que no pueda responder.
### Buscar sitios
- La búsqueda del sitio está en beta. Para habilitarla en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). + La búsqueda de sitios está en beta. Para habilitarla en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). -Configura los sitios que el assistant puede buscar para obtener contexto adicional al responder preguntas. +Configura los sitios que el assistant puede consultar para obtener contexto adicional al responder preguntas. * Los sitios deben ser de acceso público. * No se admiten sitios que requieran JavaScript para cargarse. @@ -62,23 +62,23 @@ Configura los sitios que el assistant puede buscar para obtener contexto adicion Puedes usar la siguiente sintaxis de filtrado al configurar sitios externos: * **Filtrado a nivel de domain** - * `example.com`: Buscar solo el domain `example.com` - * `docs.example.com`: Buscar solo el subdomain `docs.example.com` + * `example.com`: Buscar solo en el domain `example.com` + * `docs.example.com`: Buscar solo en el subdomain `docs.example.com` * `*.example.com`: Buscar todos los subdomains de `example.com` * **Filtrado a nivel de ruta** - * `docs.example.com/api`: Buscar todas las páginas en la subruta `/api` -* **Varios patrones** + * `docs.example.com/api`: Buscar todas las páginas bajo la subruta `/api` +* **Múltiples patrones** * Agrega varias entradas para abarcar diferentes secciones de los sitios
### Límite de gasto
-Establece un límite de gasto para controlar qué sucede si alcanzas tu cupo de mensajes. De forma predeterminada, el assistant seguirá respondiendo las preguntas de los usuarios después de que alcances tu cupo de mensajes, lo que generará cargos por excedente. +Establece un límite de gasto para controlar qué sucede si alcanzas tu cupo de mensajes. De forma predeterminada, el assistant seguirá respondiendo las preguntas de los usuarios después de que alcances tu cupo de mensajes, lo que genera cargos por excedente. -En la pestaña **Billing** de la página [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings), puedes establecer un límite de gasto para los mensajes del assistant que excedan tu cupo. Cuando alcanzas tu límite de gasto, el assistant se deshabilita hasta que se restablezca tu cupo de mensajes. +En la pestaña **Billing** de la página [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings), puedes establecer un límite de gasto para los mensajes del assistant más allá de tu cupo. Cuando alcanzas tu límite de gasto, el assistant se desactiva hasta que se restablece tu cupo de mensajes. -También puedes configurar alertas de uso para recibir un correo electrónico cuando alcances un porcentaje determinado de tu límite de gasto. +También puedes configurar alertas de uso para recibir un correo electrónico cuando alcances cierto porcentaje de tu límite de gasto.
## Uso del assistant @@ -106,51 +106,51 @@ Los usuarios pueden acceder al assistant de tres maneras: }} alt="Barra de búsqueda y botón del assistant en modo oscuro." /> -* **URLs** con `?assistant=open` añadido abrirán el assistant cuando cargue la página. Por ejemplo, [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open). +* **URLs** con `?assistant=open` al final abrirán el assistant cuando cargue la página. Por ejemplo, [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open). -Estos métodos abren un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant buscará una respuesta en tu documentación. Si no se encuentra información relevante, el assistant responderá que no puede contestarla. +Estos métodos abren un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant buscará una respuesta en tu documentación. Si no se encuentra información relevante, el assistant indicará que no puede responder la pregunta.
- ## Lograr que el contenido sea apto para la IA + ## Hacer que el contenido sea apto para la IA
-Estructura tu documentación para ayudar al assistant a ofrecer respuestas precisas y relevantes. Una organización clara y un contexto completo benefician tanto a las personas lectoras como a la comprensión de la IA. +Estructura tu documentación para ayudar al assistant a proporcionar respuestas precisas y relevantes. Una organización clara y un contexto completo benefician tanto a las personas lectoras como a la comprensión de la IA. * Usa marcado semántico. * Escribe encabezados descriptivos para las secciones. - * Crea una jerarquía lógica de información. - * Mantén un formato coherente en toda tu documentación. + * Crea una jerarquía de información lógica. + * Usa un formato coherente en toda tu documentación. * Incluye metadata completa en el frontmatter de la página. * Divide los bloques largos de texto en párrafos más cortos. - * Define términos y siglas específicas cuando se mencionen por primera vez. - * Ofrece contenido conceptual suficiente sobre funcionalidades y procedimientos. + * Define términos y siglas específicas cuando se introduzcan por primera vez. + * Proporciona suficiente contenido conceptual sobre funcionalidades y procedimientos. * Incluye ejemplos y casos de uso. - * Añade referencias cruzadas a temas relacionados. - * Agrega [páginas ocultas](/es/guides/hidden-pages) con contexto adicional que las personas usuarias no necesitan, pero a las que el assistant puede recurrir. + * Haz referencias cruzadas a temas relacionados. + * Agrega [páginas ocultas](/es/guides/hidden-pages) con contexto adicional que las personas usuarias no necesitan, pero a las que el assistant puede hacer referencia.
## Exportar y analizar consultas
-Revisa y exporta consultas desde tu dashboard para entender cómo las personas interactúan con tu documentación e identificar oportunidades de mejora. Algunas formas en que el análisis de consultas puede ayudarte a mejorar tu documentación: +Revisa y exporta consultas desde tu dashboard para comprender cómo las personas interactúan con tu documentación e identificar oportunidades de mejora. Algunas formas en que el análisis de consultas puede ayudarte a mejorar tu documentación: -* Identifica brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes. -* Descubre patrones de comportamiento de los usuarios y necesidades de información comunes a partir de los temas y patrones en las consultas. -* Prioriza las páginas con mayor tráfico para mejorar su precisión y calidad. +* Identificar brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes. +* Descubrir patrones de comportamiento de los usuarios y necesidades de información comunes a partir de los temas y patrones en las consultas. +* Priorizar las páginas con mayor tráfico para mejorar su precisión y calidad. -Puedes explorar consultas desde tu [dashboard](https://dashboard.mintlify.com/products/assistant), pero para obtener información más valiosa recomendamos exportar un archivo `CSV` con tus consultas, respuestas y fuentes para analizarlo con tu herramienta de IA preferida. +Puedes explorar las consultas desde tu [dashboard](https://dashboard.mintlify.com/products/assistant), pero para obtener insights más potentes recomendamos exportar un archivo `CSV` con tus consultas, respuestas y fuentes para analizarlo con tu herramienta de IA preferida. 1. Ve a la [página del assistant](https://dashboard.mintlify.com/products/assistant) en tu dashboard. 2. Selecciona **Export to CSV**. 3. Analiza los datos exportados con tu herramienta preferida. - + * Resume los temas más comunes de las consultas. * Enumera las consultas que no tengan fuentes citadas. - * Encuentra patrones en interacciones fallidas. + * Encuentra patrones en interacciones sin éxito. \ No newline at end of file diff --git a/es/guides/auth0.mdx b/es/guides/auth0.mdx index d9ac047a6..6db34be03 100644 --- a/es/guides/auth0.mdx +++ b/es/guides/auth0.mdx @@ -1,10 +1,10 @@ --- -title: "Uso de Auth0 con el protocolo de OAuth" -description: "Si Auth0 es la fuente confiable de los datos de tus usuarios, puedes configurar Mintlify como una aplicación cliente de OAuth para autenticar a tus usuarios." +title: "Uso de Auth0 con el intercambio OAuth" +description: "Si Auth0 es la fuente de verdad para los datos de tus usuarios, puedes configurar Mintlify como una aplicación cliente de OAuth para autenticar a tus usuarios." --- - **Aviso de seguridad**: Aunque proporcionamos esta guía para ayudarte a integrar Auth0 con Mintlify, consulta con tu equipo de seguridad antes de implementar cualquier solución de autenticación. Mintlify no es responsable de ningún problema de seguridad que pueda surgir de tu implementación específica. + **Aviso de seguridad**: Aunque proporcionamos esta guía para ayudarte a integrar Auth0 con Mintlify, consulta con tu equipo de seguridad antes de implementar cualquier solución de autenticación. Mintlify no se hace responsable de ningún problema de seguridad que pueda surgir de tu implementación específica.
@@ -15,7 +15,7 @@ Esta guía te explica cómo configurar Auth0 como proveedor de autenticación pa - Inicia sesión en tu dashboard de Auth0 y navega a **Applications** > **Applications**. Haz clic en el botón **Create Application**, asigna un nombre a tu aplicación (por ejemplo, "Mintlify") y selecciona **Regular Web Applications** como tipo de aplicación. Luego haz clic en **Create**. + Inicia sesión en tu dashboard de Auth0 y ve a **Applications** > **Applications**. Haz clic en el botón **Create Application**, asigna un nombre a tu aplicación (por ejemplo, "Mintlify") y selecciona **Regular Web Applications** como tipo de aplicación. Luego haz clic en **Create**. ![Creación de una nueva aplicación en Auth0](/images/guides/auth0/auth0-create-application.png) @@ -27,7 +27,7 @@ Esta guía te explica cómo configurar Auth0 como proveedor de autenticación pa Toma nota de la siguiente información: - **Domain**: Este es el domain de tu tenant de Auth0 (por ejemplo, `your-tenant.auth0.com`) - **Client ID**: El identificador público de tu aplicación - - **Client Secret**: La key secreta de tu aplicación (mantén esto en un lugar seguro) + - **Client Secret**: La clave secreta de tu aplicación (mantén esto seguro) Necesitarás estos valores para configurar Mintlify en el siguiente paso. @@ -44,17 +44,17 @@ Esta guía te explica cómo configurar Auth0 como proveedor de autenticación pa - **Scopes**: Déjalo en blanco a menos que tengas scopes personalizados configurados en Auth0 - **Token URL**: `https://YOUR_AUTH0_DOMAIN/oauth/token` (reemplaza `YOUR_AUTH0_DOMAIN` con tu domain real de Auth0) - Después de completar estos datos, haz clic en **Guardar cambios** para guardar tu configuración de OAuth. + Después de completar estos detalles, haz clic en **Guardar cambios** para almacenar tu configuración de OAuth. Mintlify generará una Redirect URL única que Auth0 debe reconocer para que el flujo de OAuth funcione correctamente. - Copia la Redirect URL desde la configuración de Autenticación en tu Dashboard de Mintlify: + Copia la Redirect URL desde la configuración de Authentication en tu Dashboard de Mintlify: ![URL de redirección de Mintlify](/images/guides/auth0/mintlifyredirecturl.png) Regresa a la página de configuración de tu aplicación en Auth0, desplázate hasta la sección **Application URIs** y pega la Redirect URL en el campo **Allowed Callback URLs**: - ![Configuración de URL de redirección en Auth0](/images/guides/auth0/auth0redirecturl.png) + ![Configuración de la URL de redirección en Auth0](/images/guides/auth0/auth0redirecturl.png) - Haz clic en **Save Changes** al final de la página de Auth0 para aplicar esta configuración. + Haz clic en **Save Changes** en la parte inferior de la página de Auth0 para aplicar esta configuración. \ No newline at end of file diff --git a/es/guides/changelogs.mdx b/es/guides/changelogs.mdx index 9d178bf7f..1f4de0877 100644 --- a/es/guides/changelogs.mdx +++ b/es/guides/changelogs.mdx @@ -1,27 +1,27 @@ --- -title: "Registro de cambios" +title: "Cambios" description: "Publica actualizaciones de producto en tu documentación con un canal RSS al que los usuarios pueden suscribirse" icon: "newspaper" --- -Crea un registro de cambios para tu documentación añadiendo [componentes Update](/es/components/update) a una página. +Crea una página de cambios para tu documentación añadiendo [componentes Update](/es/components/update) a una página. Consulta el [registro de cambios de Mintlify](/es/changelog) como ejemplo: en cada actualización puedes incluir enlaces, imágenes, texto y demos de tus nuevas funciones.
- ## Configura tu registro de cambios + ## Configurar tu página de cambios
- - 1. Crea una nueva página en tu documentación, como `changelog.mdx` o `updates.mdx`. - 2. Agrega la página de cambios a tu esquema de navigation en `docs.json`. + + 1. Crea una nueva página en tu documentación, por ejemplo `changelog.mdx` o `updates.mdx`. + 2. Agrega la página de cambios a tu esquema de navigation en tu `docs.json`. - + Agrega un `Update` por cada entrada del registro. - Incluye información relevante como lanzamientos de funcionalidades, correcciones de errores u otros anuncios. + Incluye información relevante como lanzamientos de funciones, correcciones de errores u otros anuncios. @@ -42,28 +42,28 @@ description: "Actualizaciones del producto y anuncios" ```
- ## Personaliza tu changelog + ## Personalización de tu página de cambios
-Controla cómo las personas navegan por tu changelog y se mantienen al día con la información de tu producto. +Controla cómo las personas navegan por tu página de cambios y se mantienen al día con la información de tu producto.
### Tabla de contenidos
-Cada propiedad `label` de un `Update` crea automáticamente una entrada en la tabla de contenidos de la barra lateral derecha. Esta es la navigation predeterminada para tu changelog. +Cada propiedad `label` de un `Update` crea automáticamente una entrada en la tabla de contenidos de la barra lateral derecha. Esta es la navigation predeterminada para tu página de cambios. - Changelog con la tabla de contenidos mostrada en modo claro. + Página de cambios con la tabla de contenidos mostrada en modo claro. - Changelog con la tabla de contenidos mostrada en modo oscuro. + Página de cambios con la tabla de contenidos mostrada en modo oscuro.
- ### Filtros por etiquetas + ### Filtros de etiquetas
-Agrega `tags` a tus componentes `Update` para reemplazar la tabla de contenidos por filtros de etiquetas. Los usuarios pueden filtrar el changelog seleccionando una o más etiquetas: +Agrega `tags` a tus componentes `Update` para reemplazar la tabla de contenidos por filtros de etiquetas. Los usuarios pueden filtrar la página de cambios seleccionando una o más etiquetas: ```mdx Tag filters example wrap @@ -84,24 +84,24 @@ Agrega `tags` a tus componentes `Update` para reemplazar la tabla de contenidos ``` - Changelog en modo claro con el filtro de etiqueta Peppermint seleccionado. + Registro de cambios en modo claro con el filtro de etiqueta Peppermint seleccionado. - Changelog en modo oscuro con el filtro de etiqueta Peppermint seleccionado. + Registro de cambios en modo oscuro con el filtro de etiqueta Peppermint seleccionado. - La tabla de contenido y los filtros del changelog se ocultan cuando usas los modos de página `custom`, `center` o `wide`. Obtén más información sobre los [modos de página](/es/pages#page-mode). + La tabla de contenido y los filtros del registro de cambios se ocultan cuando se usan los modos de página `custom`, `center` o `wide`. Más información sobre los [modos de página](/es/pages#page-mode).
- ### Changelogs suscribibles + ### Registros de cambios suscribibles
-Usar componentes `Update` crea un feed RSS al que te puedes suscribir en la URL de tu página con `/rss.xml` añadido. Por ejemplo, `mintlify.com/docs/changelog/rss.xml`. +El uso de componentes `Update` crea un feed RSS al que te puedes suscribir en la URL de tu página con `/rss.xml` añadido. Por ejemplo, `mintlify.com/docs/changelog/rss.xml`. -Las entradas se agregan al feed RSS cuando se publican nuevos componentes `Update` y cuando se añaden nuevos encabezados dentro de etiquetas `` existentes. +Las entradas se añaden al feed RSS cuando se publican nuevos componentes `Update` y cuando se agregan nuevos encabezados dentro de etiquetas `` existentes. -Los encabezados de nivel superior de los componentes `Update` se usan como títulos de las entradas del feed RSS, y estas enlazan a sus anclas de encabezado en tu documentación. +Los encabezados de nivel superior de los componentes `Update` se usan como títulos de las entradas del feed RSS, y las entradas enlazan a sus anclas de encabezado en tu documentación. ```xml Example RSS feed @@ -125,13 +125,13 @@ Los encabezados de nivel superior de los componentes `Update` se usan como títu ``` -Las fuentes RSS pueden integrarse con Slack, correo electrónico u otras herramientas de suscripción para notificar a los usuarios sobre cambios en el producto. Algunas opciones incluyen: +Los feeds RSS pueden integrarse con Slack, el correo electrónico u otras herramientas de suscripción para notificar a los usuarios sobre cambios en el producto. Algunas opciones incluyen: * [Slack](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack) -* [Correo electrónico](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email) a través de Zapier +* [Correo electrónico](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email) vía Zapier * Bots de Discord como [Readybot](https://readybot.io) o [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot) -Para facilitar el descubrimiento del feed RSS, puedes mostrar un botón con el icon de RSS que enlace al feed en la parte superior de la página. Agrega `rss: true` al frontmatter de la página: +Para que el feed RSS sea fácil de descubrir, puedes mostrar un botón con el icono de RSS que enlace al feed en la parte superior de la página. Agrega `rss: true` al frontmatter de la página: ```mdx --- @@ -140,7 +140,7 @@ rss: true ``` - Página de cambios en modo claro con el botón del feed RSS activado. + Página de cambios en modo claro con el botón del feed RSS habilitado. - Página de cambios en modo oscuro con el botón del feed RSS activado. + Página de cambios en modo oscuro con el botón del feed RSS habilitado. diff --git a/es/guides/claude-code.mdx b/es/guides/claude-code.mdx index bbc45c91e..65e5c64d8 100644 --- a/es/guides/claude-code.mdx +++ b/es/guides/claude-code.mdx @@ -6,10 +6,10 @@ icon: "asterisk" Claude Code es una herramienta de línea de comandos con capacidades de agente que puede ayudarte a mantener tu documentación. Puede redactar contenido nuevo, revisar páginas existentes y mantener la documentación actualizada. -Puedes entrenar Claude Code para que entienda tus estándares y flujos de trabajo de documentación añadiendo un archivo `CLAUDE.md` a tu proyecto y refinándolo con el tiempo. +Puedes entrenar Claude Code para que comprenda tus estándares y flujos de trabajo de documentación añadiendo un archivo `CLAUDE.md` a tu proyecto y perfeccionándolo con el tiempo.
- ## Primeros pasos + ## Introducción
**Requisitos previos:** @@ -24,8 +24,8 @@ Puedes entrenar Claude Code para que entienda tus estándares y flujos de trabaj npm install -g @anthropic-ai/claude-code ``` -2. Ve al directorio de tu documentación. -3. (Opcional) Añade el archivo `CLAUDE.md` que aparece a continuación a tu proyecto. +2. Ve a tu directorio de docs. +3. (Opcional) Añade el archivo `CLAUDE.md` a tu proyecto. 4. Ejecuta `claude` para empezar. @@ -33,9 +33,9 @@ Puedes entrenar Claude Code para que entienda tus estándares y flujos de trabaj ## Plantilla CLAUDE.md
-Guarda un archivo `CLAUDE.md` en la raíz de tu directorio de documentación para ayudar a Claude Code a comprender tu proyecto. Este archivo entrena a Claude Code con tus estándares de documentación, preferencias y flujos de trabajo. Consulta [Manage Claude's memory](https://docs.anthropic.com/en/docs/claude-code/memory) en la documentación de Anthropic para obtener más información. +Guarda un archivo `CLAUDE.md` en la raíz de tu directorio de documentación para ayudar a Claude Code a comprender tu proyecto. Este archivo entrena a Claude Code en tus estándares de documentación, preferencias y flujos de trabajo. Consulta [Manage Claude's memory](https://docs.anthropic.com/en/docs/claude-code/memory) en la documentación de Anthropic para obtener más información. -Copia esta plantilla de ejemplo o ajústala según las especificaciones de tu documentación: +Copia esta plantilla de ejemplo o ajusta lo necesario según las especificaciones de tu documentación: ```mdx # Documentación de Mintlify @@ -92,16 +92,16 @@ Copia esta plantilla de ejemplo o ajústala según las especificaciones de tu do
- ## Ejemplos de prompts + ## Ejemplos de indicaciones
-Una vez que tengas configurado Claude Code, prueba estos prompts para ver cómo puede ayudarte con tareas habituales de documentación. Puedes copiar y pegar estos ejemplos directamente o adaptarlos a tus necesidades específicas. +Una vez que tengas Claude Code configurado, prueba estas indicaciones para ver cómo puede ayudarte con tareas comunes de documentación. Puedes copiar y pegar estos ejemplos directamente o adaptarlos a tus necesidades específicas.
### Convierte notas en documentación de calidad
-Convierte borradores en páginas Markdown completas con componentes y frontmatter. +Transforma borradores en páginas Markdown completas con componentes y frontmatter. **Ejemplo de solicitud:** @@ -116,7 +116,7 @@ Convierte este texto en una página MDX con el formato correcto: [pega tu texto Obtén sugerencias para mejorar el estilo, el formato y el uso de componentes. -**Ejemplo de prompt:** +**Ejemplo de solicitud:** ```text wrap Revisa los archivos en docs/ y sugiere mejoras para mantener la consistencia y claridad @@ -124,12 +124,12 @@ Revisa los archivos en docs/ y sugiere mejoras para mantener la consistencia y c
- ### Actualiza la documentación cuando cambien las funcionalidades + ### Actualiza la documentación cuando cambian las funcionalidades
Mantén la documentación al día a medida que tu producto evoluciona. -**Ejemplo de prompt:** +**Ejemplo:** ```text wrap Nuestra API ahora requiere un parámetro de versión. Actualiza nuestra documentación para incluir version=2024-01 en todos los ejemplos @@ -153,16 +153,16 @@ Crea ejemplos de código para [tu endpoint de API] en JavaScript, Python y cURL ## Ampliar Claude Code
-Además de indicarle instrucciones manualmente a Claude Code, puedes integrarlo en tus flujos de trabajo existentes. +Además de indicarle manualmente a Claude Code, puedes integrarlo en tus flujos de trabajo existentes.
### Automatización con GitHub Actions
-Ejecuta Claude Code automáticamente cuando haya cambios en el código para mantener la documentación actualizada. Puedes activar revisiones de la documentación en solicitudes de extracción o actualizar los ejemplos cuando se detecten cambios en la API. +Ejecuta Claude Code automáticamente cuando haya cambios en el código para mantener la documentación actualizada. Puedes activar revisiones de documentación en solicitudes de extracción o actualizar ejemplos cuando se detecten cambios en la API.
- ### Flujos de trabajo multiinstancia + ### Flujos de trabajo con múltiples instancias
Usa sesiones separadas de Claude Code para distintas tareas: una para escribir contenido nuevo y otra para la revisión y el control de calidad. Esto ayuda a mantener la coherencia y a detectar problemas que una sola sesión podría pasar por alto. @@ -171,10 +171,10 @@ Usa sesiones separadas de Claude Code para distintas tareas: una para escribir c ### Colaboración en equipo -Comparte el archivo `CLAUDE.md` perfeccionado con tu equipo para garantizar estándares de documentación coherentes entre todos los colaboradores. Los equipos suelen desarrollar indicaciones y flujos de trabajo específicos del proyecto que pasan a formar parte de su proceso de documentación. +Comparte con tu equipo el archivo `CLAUDE.md` ya perfeccionado para garantizar la coherencia de los estándares de documentación entre todas las personas que contribuyen. Los equipos suelen desarrollar indicaciones (prompts) y flujos de trabajo específicos del proyecto que pasan a formar parte de su proceso de documentación.
### Comandos personalizados
-Crea comandos de barra (slash) reutilizables en `.claude/commands/` para tareas de documentación frecuentes específicas de tu proyecto o equipo. \ No newline at end of file +Crea comandos de barra diagonal reutilizables en `.claude/commands/` para tareas de documentación frecuentes específicas de tu proyecto o equipo. \ No newline at end of file diff --git a/es/guides/csp-configuration.mdx b/es/guides/csp-configuration.mdx index e63c2d5bc..ebd223841 100644 --- a/es/guides/csp-configuration.mdx +++ b/es/guides/csp-configuration.mdx @@ -1,10 +1,10 @@ --- title: "Configuración de Content Security Policy (CSP)" sidebarTitle: "Configuración de CSP" -description: "Lista de permitidos de domain y configuraciones de encabezados para proxies inversos, firewalls y redes que aplican políticas de seguridad estrictas" +description: "Lista de permitidos del domain y configuraciones de encabezados para proxies inversos, firewalls y redes que aplican políticas de seguridad estrictas" --- -Content Security Policy (CSP) es un estándar de seguridad que ayuda a prevenir ataques de cross-site scripting (XSS) controlando qué recursos puede cargar una página web. Mintlify proporciona una CSP predeterminada que protege a la mayoría de los sitios. Si alojas tu documentación detrás de un proxy inverso o un firewall que sobrescribe la CSP predeterminada, es posible que necesites configurar encabezados CSP para que las funciones operen correctamente. +Content Security Policy (CSP) es un estándar de seguridad que ayuda a prevenir ataques de cross-site scripting (XSS) al controlar qué recursos puede cargar una página web. Mintlify sirve una CSP predeterminada que protege a la mayoría de los sitios. Si alojas tu documentación detrás de un proxy inverso o un firewall que sobrescribe la CSP predeterminada, es posible que debas configurar los encabezados de CSP para que las funciones funcionen correctamente.
## Directivas CSP @@ -17,25 +17,25 @@ Las siguientes directivas de CSP se utilizan para controlar qué recursos se pue - `font-src`: Controla qué fuentes se pueden cargar - `img-src`: Controla qué imágenes, iconos y logotipos se pueden cargar - `connect-src`: Controla a qué URL se puede conectar para llamadas a la API y conexiones WebSocket -- `frame-src`: Controla qué URL se pueden incrustar en marcos o iframes -- `default-src`: Valor de reserva para otras directivas cuando no se especifica explícitamente +- `frame-src`: Controla qué URL se pueden insertar en frames o iframes +- `default-src`: Valor predeterminado para otras directivas cuando no se especifican explícitamente
- ## Lista de dominios permitidos + ## Lista de permitidos de dominios
-| Domain | Propósito | Directiva CSP | Obligatorio | +| Dominio | Propósito | Directiva CSP | Obligatorio | |:-------|:--------|:--------------|:-------| -| `d4tuoctqmanu0.cloudfront.net` | CSS y fuentes de KaTeX | `style-src`, `font-src` | Obligatorio | +| `d4tuoctqmanu0.cloudfront.net` | KaTeX CSS, fuentes | `style-src`, `font-src` | Obligatorio | | `*.mintlify.dev` | Contenido de la documentación | `connect-src`, `frame-src` | Obligatorio | | `*.mintlify.com` | Dashboard, API, proxy de Analytics | `connect-src` | Obligatorio | | `leaves.mintlify.com` | API del assistant | `connect-src` | Obligatorio | | `d3gk2c5xim1je2.cloudfront.net` | Iconos, imágenes, logotipos | `img-src` | Obligatorio | -| `d1ctpt7j8wusba.cloudfront.net` | Archivos de versión y de lanzamiento de Mint | `connect-src` | Obligatorio | +| `d1ctpt7j8wusba.cloudfront.net` | Archivos de versión y lanzamiento de Mint | `connect-src` | Obligatorio | | `mintcdn.com` | Imágenes, favicons | `img-src`, `connect-src` | Obligatorio | | `*.mintcdn.com` | Imágenes, favicons | `img-src`, `connect-src` | Obligatorio | | `api.mintlifytrieve.com` | API de búsqueda | `connect-src` | Obligatorio | -| `cdn.jsdelivr.net` | Recursos de emojis para imágenes OG | `script-src`, `img-src` | Obligatorio | +| `cdn.jsdelivr.net` | Recursos de emoji para imágenes OG | `script-src`, `img-src` | Obligatorio | | `fonts.googleapis.com` | Google Fonts | `style-src`, `font-src` | Opcional | | `www.googletagmanager.com` | Google Analytics/GTM | `script-src`, `connect-src` | Opcional | | `cdn.segment.com` | Segment Analytics | `script-src`, `connect-src` | Opcional | @@ -54,7 +54,7 @@ Las siguientes directivas de CSP se utilizan para controlar qué recursos se pue
- Incluye solo los domain de los servicios que usas. Elimina cualquier domain de Analytics que no hayas configurado para tu documentación. + Incluye solo los domain de los servicios que uses. Elimina cualquier domain de Analytics que no hayas configurado para tu documentación. ```text wrap @@ -124,7 +124,7 @@ Agrega una política de encabezados de respuesta en CloudFront: ### Configuración de Vercel -Agrega lo siguiente a tu `vercel.json`: +Agrega en tu `vercel.json`: ```json { @@ -147,11 +147,11 @@ Agrega lo siguiente a tu `vercel.json`: ## Solución de problemas -Identifica infracciones de la CSP en la consola de tu navegador: +Identifica infracciones de CSP en la consola de tu navegador: -1. Abre las herramientas de desarrollador de tu navegador. +1. Abre las herramientas de desarrollo de tu navegador. 2. Ve a la pestaña **Console**. -3. Busca errores que comiencen con: +3. Busca errores que empiecen por: - `Content Security Policy: The page's settings blocked the loading of a resource` - `Refused to load the script/stylesheet because it violates the following Content Security Policy directive` - `Refused to connect to because it violates the following Content Security Policy directive` \ No newline at end of file diff --git a/es/guides/cursor.mdx b/es/guides/cursor.mdx index 1c5b69788..cefc83cad 100644 --- a/es/guides/cursor.mdx +++ b/es/guides/cursor.mdx @@ -4,7 +4,7 @@ description: "Configura Cursor como tu assistant de redacción" icon: "box" --- -Convierte Cursor en un experto en documentación que conozca tus componentes, la guía de estilo y las mejores prácticas. +Convierte Cursor en un experto en documentación que domine tus componentes, tu guía de estilo y tus mejores prácticas. @@ -12,14 +12,14 @@ Convierte Cursor en un experto en documentación que conozca tus componentes, la ## Uso de Cursor con Mintlify -Las reglas de Cursor aportan contexto persistente sobre tu documentación, lo que asegura sugerencias más coherentes y alineadas con tus estándares y estilo. +Las reglas de Cursor proporcionan contexto persistente sobre tu documentación, lo que garantiza sugerencias más coherentes que se ajusten a tus estándares y estilo. -* **Las reglas del proyecto** se almacenan en el repositorio de tu documentación y se comparten con tu equipo. -* **Las reglas del usuario** se aplican a tu entorno personal de Cursor. +* **Las reglas de proyecto** se almacenan en el repositorio de tu documentación y se comparten con tu equipo. +* **Las reglas de usuario** se aplican a tu entorno personal de Cursor. Recomendamos crear reglas de proyecto para tu documentación, de modo que todas las personas colaboradoras tengan acceso a las mismas reglas. -Crea archivos de reglas en el directorio `.cursor/rules` de tu repositorio de documentación. Consulta la [documentación de Cursor Rules](https://docs.cursor.com/context/rules) para obtener instrucciones completas de configuración. +Crea archivos de reglas en el directorio `.cursor/rules` de tu repositorio de documentación. Consulta la [documentación de Cursor Rules](https://docs.cursor.com/context/rules) para obtener las instrucciones completas de configuración. @@ -27,16 +27,16 @@ Crea archivos de reglas en el directorio `.cursor/rules` de tu repositorio de do ## Regla de ejemplo del proyecto -Esta regla le brinda a Cursor el contexto necesario para formatear correctamente los componentes de Mintlify y seguir las mejores prácticas de redacción técnica. +Esta regla brinda a Cursor el contexto necesario para formatear correctamente los componentes de Mintlify y seguir las mejores prácticas de redacción técnica. Puedes usar este ejemplo tal cual o personalizarlo para tu documentación: -* **Estándares de redacción**: Actualiza las pautas lingüísticas para que se alineen con tu guía de estilo. -* **Patrones de componentes**: Añade componentes específicos del proyecto o modifica los ejemplos existentes. -* **Ejemplos de código**: Sustituye los ejemplos genéricos por llamadas y respuestas reales de la API de tu producto. +* **Estándares de redacción**: Actualiza las pautas lingüísticas para alinearlas con tu guía de estilo. +* **Patrones de componentes**: Agrega componentes específicos del proyecto o modifica los ejemplos existentes. +* **Ejemplos de código**: Reemplaza los ejemplos genéricos con llamadas y respuestas reales de tu API. * **Preferencias de estilo y tono**: Ajusta la terminología, el formato y otras reglas. -Agrega esta regla, con las modificaciones que necesites, como un archivo `.mdc` en el directorio `.cursor/rules` de tu repositorio de documentación. +Agrega esta regla, con cualquier modificación, como un archivo `.mdc` en el directorio `.cursor/rules` de tu repositorio de documentación. @@ -377,9 +377,9 @@ API #### Updates -Usa updates para registros de cambios: +Usa updates para changelogs: - + ## Nuevas características - Se agregó funcionalidad de importación masiva de usuarios - Se mejoraron los mensajes de error con sugerencias accionables @@ -389,7 +389,7 @@ Usa updates para registros de cambios: - Se resolvieron problemas de tiempo de espera de autenticación -## Estructura de página obligatoria +## Estructura de página requerida Cada página de documentación debe comenzar con frontmatter YAML: @@ -425,7 +425,7 @@ description: "Descripción concisa explicando el propósito y valor de la págin ### Requisitos de accesibilidad - Incluye texto alternativo descriptivo para todas las imágenes y diagramas -- Usa texto de enlace específico y accionable en lugar de "haz clic aquí" +- Usa texto de enlace específico y procesable en lugar de "haz clic aquí" - Asegura una jerarquía de encabezados adecuada comenzando con H2 - Proporciona consideraciones de navegación por teclado - Usa contraste de color suficiente en ejemplos y elementos visuales diff --git a/es/guides/deployments.mdx b/es/guides/deployments.mdx index c53eefac5..2c9c435cc 100644 --- a/es/guides/deployments.mdx +++ b/es/guides/deployments.mdx @@ -4,23 +4,23 @@ description: "Soluciona problemas de tus implementaciones" icon: "boxes" --- -Tu sitio de documentación se implementa automáticamente cuando subes cambios a tu repositorio conectado. Para ello, la Aplicación de GitHub de Mintlify debe estar correctamente instalada y conectada. +Tu sitio de documentación se implementa automáticamente cuando haces push de cambios al repositorio conectado. Para ello, la Aplicación de GitHub de Mintlify debe estar correctamente instalada y conectada. -Si tus cambios más recientes no aparecen en tu sitio en producción, primero verifica que la Aplicación de GitHub esté instalada en la cuenta u organización propietaria de tu repositorio de documentación. Consulta [Solución de problemas de GitHub](/es/settings/github#troubleshooting) para obtener más información. +Si tus cambios más recientes no aparecen en el sitio en producción, primero verifica que la Aplicación de GitHub esté instalada en la cuenta u organización propietaria de tu repositorio de documentación. Consulta [Solución de problemas de GitHub](/es/settings/github#troubleshooting) para más información. -Si la Aplicación de GitHub está conectada, pero los cambios aún no se implementan, puedes activar manualmente una reconstrucción desde tu dashboard. +Si la Aplicación de GitHub está conectada pero los cambios siguen sin implementarse, puedes activar manualmente una reconstrucción desde tu dashboard.
## Activar una implementación manualmente
- - Comprueba que tu confirmación más reciente aparece en tu repositorio de documentación y que no tuvo ningún error. + + Comprueba que tu confirmación más reciente aparece en tu repositorio de documentación y que no presentó errores. - Ve a tu [dashboard](https://dashboard.mintlify.com) y selecciona el botón de implementar. + Ve a tu [dashboard](https://dashboard.mintlify.com) y selecciona el botón de implementación. El botón de actualización manual resaltado con un rectángulo naranja. diff --git a/es/guides/geo.mdx b/es/guides/geo.mdx index b28ecda44..c78a097f7 100644 --- a/es/guides/geo.mdx +++ b/es/guides/geo.mdx @@ -1,13 +1,13 @@ --- -title: "Guía GEO: optimiza la documentación para la búsqueda y los motores de respuesta con IA" +title: "Guía de GEO: optimiza la documentación para la búsqueda y los motores de respuestas con IA" sidebarTitle: "GEO" -description: "Haz que tu documentación sea más fácil de descubrir y citada con mayor frecuencia por herramientas de IA" +description: "Haz que tu documentación sea más fácil de descubrir y más citada por las herramientas de IA" icon: "cpu" --- -Optimiza tu documentación tanto para los buscadores tradicionales como para los motores de respuesta con IA como ChatGPT, Perplexity y Google AI Overviews. +Optimiza tu documentación tanto para los motores de búsqueda tradicionales como para los motores de respuestas con IA, como ChatGPT, Perplexity y Google AI Overviews. -La Optimización para Motores Generativos (GEO) se enfoca en lograr citas de sistemas de IA mediante contenido exhaustivo e información estructurada, mientras que el SEO tradicional se orienta a mejorar el posicionamiento en los resultados de búsqueda. +La Optimización para Motores Generativos (GEO) se centra en ser citado por sistemas de IA mediante contenido completo e información estructurada, mientras que el SEO tradicional apunta a la clasificación en los resultados de búsqueda. @@ -19,30 +19,30 @@ La Optimización para Motores Generativos (GEO) se enfoca en lograr citas de sis ### Configuración inicial -1. **Asegúrate de que tu documentación esté indexada** en la configuración de `docs.json` +1. **Asegúrate de que tu documentación esté indexándose** en la configuración de `docs.json` 2. **Audita las páginas actuales** para detectar descripciones y títulos faltantes
### Mejoras de contenido
-1. **Agrega tablas comparativas** a las páginas correspondientes -2. **Audita los encabezados** para asegurarte de que respondan a preguntas frecuentes -3. **Mejora los enlaces internos** entre temas relacionados -4. **Prueba con herramientas de IA** para verificar la exactitud +1. **Agrega tablas comparativas** en las páginas correspondientes +2. **Audita los encabezados** para asegurarte de que respondan preguntas frecuentes +3. **Mejora el enlazado interno** entre temas relacionados +4. **Prueba con herramientas de IA** para verificar la precisión
- ## Mejores prácticas de GEO + ## Buenas prácticas de GEO
-En general, una documentación bien escrita y bien estructurada tendrá un GEO sólido. Aun así, prioriza escribir para tus usuarios; si tu contenido satisface sus necesidades, estarás bien encaminado para optimizar para herramientas de IA. Crear contenido realmente útil, en lugar de optimizar por optimizar, es recompensado tanto por los motores de búsqueda tradicionales como por los de IA. +En general, una documentación bien escrita y bien estructurada tendrá un buen desempeño en GEO. Aun así, prioriza escribir para tus usuarios y, si tu contenido satisface sus necesidades, ya estarás encaminado a optimizar para las herramientas de IA. Crear contenido realmente útil, en lugar de optimizar por optimizar, es premiado tanto por los buscadores tradicionales como por los de IA. Enfócate en: - Contenido alineado con las necesidades del usuario en lugar de la coincidencia de palabras clave -- Información estructurada y fácil de escanear +- Información estructurada y fácil de recorrer con la vista - Respuestas directas a las preguntas
@@ -51,17 +51,17 @@ Enfócate en: Estas prácticas de formato ayudan a las herramientas de IA a analizar y comprender tu contenido: -- No te saltes niveles de encabezado (H1 → H2 → H3) +- No omitas niveles de encabezado (H1 → H2 → H3) - Usa nombres de objetos específicos en lugar de “it” o “this” - Etiqueta los bloques de código con su lenguaje de programación -- Proporciona texto alternativo descriptivo en las imágenes -- Enlaza a conceptos relacionados para ayudar a la IA a entender las relaciones +- Proporciona texto alternativo descriptivo para las imágenes +- Vincula conceptos relacionados para ayudar a la IA a entender las relaciones
- ### Responde preguntas directamente + ### Responde las preguntas directamente
-Escribe contenido que aborde preguntas específicas de los usuarios: +Escribe contenido que responda a preguntas específicas de los usuarios: - Comienza las secciones con la idea principal - Usa encabezados descriptivos que coincidan con consultas comunes @@ -79,7 +79,7 @@ Usa estas funciones para mejorar el SEO. ### Agrega metadata descriptiva de la página
-Incluye títulos y descripciones claras en tu frontmatter: +Incluye títulos y descripciones claros en tu frontmatter: ```mdx --- @@ -89,10 +89,10 @@ description: "Guía completa para implementar autenticación de API con ejemplos ```
- ### Configura la indexación global + ### Configurar la indexación global
-Agrega lo siguiente a tu `docs.json`: +Añade a tu `docs.json`: ```json { @@ -110,19 +110,19 @@ Agrega lo siguiente a tu `docs.json`: ### LLMs.txt -Los archivos LLMs.txt ayudan a los sistemas de IA a entender la estructura de tu documentación, de forma similar a como los sitemaps ayudan a los motores de búsqueda. Mintlify genera automáticamente archivos LLMs.txt para tu documentación. No se requiere configuración. +Los archivos LLMs.txt ayudan a los sistemas de IA a entender la estructura de tu documentación, de forma similar a como los sitemaps ayudan a los motores de búsqueda. Mintlify genera automáticamente archivos LLMs.txt para tu documentación. No hace falta configuración.
- ## Pruebas de tu documentación + ## Prueba de tu documentación
-Prueba varias herramientas de IA con preguntas sobre tu producto y tu documentación para ver qué tan bien se citan tus docs. +Prueba distintas herramientas de IA con preguntas sobre tu producto y tu documentación para ver qué tan bien citan tus docs. -**Haz preguntas específicas a los asistentes de IA sobre tus docs:** -- «¿Cómo configuro la Autenticación con esta API?» -- «Guíame por el proceso de instalación paso a paso» +**Haz preguntas específicas a los Asistentes de IA sobre tus docs:** +- "¿Cómo configuro la Autenticación con esta API?" +- "Guíame paso a paso por el proceso de instalación" -**Comprueba que las herramientas proporcionen:** +**Verifica que las herramientas proporcionen:** - Ejemplos de código correctos - Instrucciones precisas paso a paso diff --git a/es/guides/hidden-page-example.mdx b/es/guides/hidden-page-example.mdx index b4dca0cbf..d509142bf 100644 --- a/es/guides/hidden-page-example.mdx +++ b/es/guides/hidden-page-example.mdx @@ -4,7 +4,7 @@ description: "Casos de uso comunes de las páginas ocultas" icon: "eye-off" --- -¡Esta página está oculta! No está incluida en la `docs.json` navigation, por lo que solo puedes acceder a ella a través de su URL. +¡Esta página está oculta! No está incluida en la navigation de `docs.json`, por lo que solo puedes acceder a ella mediante su URL. Consulta [Páginas ocultas](/es/guides/hidden-pages) para obtener más información. @@ -13,12 +13,12 @@ Consulta [Páginas ocultas](/es/guides/hidden-pages) para obtener más informaci - De forma predeterminada, las páginas ocultas son accesibles públicamente, pero no se pueden descubrir a través de la navigation. Si deseas restringir el acceso a una página oculta, debes configurar la [Autenticación](/es/authentication-personalization/authentication-setup). + De forma predeterminada, las páginas ocultas son de acceso público, pero no son descubribles a través de la navigation. Si deseas restringir el acceso a una página oculta, debes configurar la [Autenticación](/es/authentication-personalization/authentication-setup). -* **Documentación beta**: Información que puede ser pública, pero que no debería descubrirse a través de la navigation. +* **Documentación beta**: Información que puede ser pública, pero que no debería ser descubrible a través de la navigation. * **Contexto para herramientas de IA**: Si se indexan las páginas ocultas, las herramientas de IA pueden consultarlas como contexto. Usa páginas ocultas para contexto que no sea relevante para los usuarios, pero que pueda ayudar a las herramientas de IA a ofrecer respuestas más precisas. -* **Páginas anteriores**: Mantén el contenido antiguo accesible mediante enlaces directos, eliminándolo a la vez de los menús de navigation. +* **Páginas heredadas**: Mantén el contenido antiguo accesible mediante enlaces directos mientras lo retiras de los menús de navigation. * **Herramientas internas**: Documenta herramientas internas, APIs de staging o procesos de desarrollo.
diff --git a/es/guides/hidden-pages.mdx b/es/guides/hidden-pages.mdx index 38c12e8ba..fb1ff66aa 100644 --- a/es/guides/hidden-pages.mdx +++ b/es/guides/hidden-pages.mdx @@ -1,14 +1,14 @@ --- title: "Páginas ocultas" -description: "Excluye páginas de tu navigation" +description: "Excluir páginas de tu navegación" icon: "eye-closed" --- -Las páginas ocultas se eliminan de la navigation de tu sitio, pero siguen siendo accesibles públicamente para cualquiera que conozca su URL. +Las páginas ocultas se eliminan de la navegación de tu sitio, pero siguen siendo accesibles públicamente para cualquiera que conozca su URL. -Usa páginas ocultas para contenido que quieres que esté disponible en tu sitio o que sirva como contexto para herramientas de IA, pero que no sea detectable a través de la navigation. +Usa páginas ocultas para contenido que quieres que sea accesible en tu sitio o como contexto para herramientas de IA, pero que no sea descubrible a través de la navegación. -Para contenido que requiera un control de acceso estricto, debes configurar la [Autenticación](/es/authentication-personalization/authentication-setup). +Para contenido que requiere un control de acceso estricto, debes configurar la [Autenticación](/es/authentication-personalization/authentication-setup). Si quieres ocultar páginas para grupos específicos de usuarios, usa la personalización para controlar la [visibilidad de la página](/es/authentication-personalization/overview#page-visibility). @@ -16,14 +16,14 @@ Si quieres ocultar páginas para grupos específicos de usuarios, usa la persona ## Ocultar una página
-Una página está oculta si no está incluida en la propiedad `navigation` de tu `docs.json`. Para ocultar una página, elimínala de tu estructura de navegación. +Una página está oculta si no está incluida en la propiedad `navigation` de tu `docs.json`. Para ocultarla, elimínala de tu estructura de `navigation`. Las páginas ocultas usan la misma estructura de URL que las páginas normales según su ruta de archivo. Por ejemplo, `guides/hidden-page.mdx` sería accesible en `docs.yoursite.com/guides/hidden-page`. Consulta un [ejemplo de una página oculta](/es/guides/hidden-page-example). - Algunos elementos de navegación, como las barras laterales, los menús desplegables y las pestañas, pueden aparecer vacíos o desalinearse en las páginas ocultas. + Algunos elementos de navegación como las barras laterales, los menús desplegables y las pestañas pueden aparecer vacíos o alterar el diseño en las páginas ocultas.
@@ -58,7 +58,7 @@ En este ejemplo, el grupo `Getting started` está oculto, pero el grupo `Guides` ### Ocultar una Tab
-También puedes ocultar una Tab agregando la propiedad `hidden` en tu archivo `docs.json`: +También puedes ocultar una Tab agregando la propiedad `hidden` a tu archivo `docs.json`: ```json highlight={4} "tabs": [ @@ -74,10 +74,10 @@ También puedes ocultar una Tab agregando la propiedad `hidden` en tu archivo `d ```
- ## Búsqueda, SEO e indexación con IA + ## Búsqueda, SEO e indexación de IA
-De forma predeterminada, las páginas ocultas se excluyen de la indexación para los motores de búsqueda, la búsqueda interna de tu documentación y como contexto para el assistant de IA. Para incluir las páginas ocultas en los resultados de búsqueda y como contexto para el assistant, agrega la propiedad `seo` a tu `docs.json`: +De forma predeterminada, las páginas ocultas se excluyen de la indexación para los motores de búsqueda, la búsqueda interna de tu documentación y como contexto para el assistant de IA. Para incluir páginas ocultas en los resultados de búsqueda y como contexto para el assistant, agrega la propiedad `seo` a tu `docs.json`: ```json "seo": { @@ -85,4 +85,4 @@ De forma predeterminada, las páginas ocultas se excluyen de la indexación para } ``` -Para excluir una página específica, agrega `noindex: true` al frontmatter de esa página. +Para excluir una página específica, agrega `noindex: true` a su frontmatter. diff --git a/es/guides/migration.mdx b/es/guides/migration.mdx index 3ce5a8e4a..2d89617ff 100644 --- a/es/guides/migration.mdx +++ b/es/guides/migration.mdx @@ -1,10 +1,10 @@ --- title: "Migraciones" -description: "Cómo migrar la documentación desde tu plataforma actual" +description: "Cómo migrar tu documentación desde la plataforma actual" icon: "import" --- -Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la migración automatizada para las plataformas compatibles o la migración manual para tener un control total del proceso. +Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la migración automatizada para las plataformas compatibles o la migración manual para tener control total del proceso.
## Elige tu ruta de migración @@ -103,7 +103,7 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la /> } @@ -167,20 +167,20 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la Para migrar tu contenido a Mintlify, necesitarás: - * Un `docs.json` válido para la configuración de tu sitio y la navegación. Consulta [Configuración global](/es/settings) y [Navegación](/es/navigation) para más información. - * Un archivo `MDX` para cada página de tu documentación. Consulta [Páginas](/es/pages) para más información. - * (Opcional) Una especificación OpenAPI para las páginas de endpoints de tu API. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup) para más información. + * Un `docs.json` válido para la configuración de tu sitio y la navigation. Consulta [Configuración global](/es/settings) y [Navegación](/es/navigation) para obtener más información. + * Un archivo `MDX` para cada página de tu documentación. Consulta [Páginas](/es/pages) para obtener más información. + * (Opcional) Una especificación OpenAPI para las páginas de endpoints de tu API. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup) para obtener más información. 1. Si tu contenido ya está en formato `MDX`, copia las páginas a tu proyecto de Mintlify. De lo contrario, convierte tu contenido al formato `MDX`. 2. Crea tu `docs.json` haciendo referencia a las rutas de tus páginas `MDX`. - 3. Si tienes especificaciones OpenAPI, añádelas a tu `docs.json` y configura el área de pruebas de la API. + 3. Si tienes especificaciones OpenAPI, agrégalas a tu `docs.json` y configura el área de pruebas de la API. ### Migración de recursos - 1. Copia los recursos en el directorio `images/` de tu repositorio. + 1. Copia los recursos al directorio `images/` de tu repositorio. 2. Actualiza las referencias en tus archivos `MDX`: ```mdx - ![Texto alternativo](/images/screenshot.png) + ![Alt text](/images/screenshot.png) ``` @@ -189,13 +189,13 @@ Esta guía te ayuda a trasladar tu documentación existente a Mintlify. Elige la ## Lista de verificación posterior a la migración
-Después de completar la migración (automática o manual), recomendamos comprobar: +Después de completar tu migración (automática o manual), te recomendamos verificar: -* Todas las páginas se renderizan -* La navigation funciona como se espera -* Los enlaces internos se resuelven correctamente -* Las imágenes y los recursos se cargan correctamente -* Los bloques de código se muestran con el resaltado de sintaxis adecuado -* La búsqueda funciona -* La implementación está configurada -* El dominio personalizado está configurado +* Que todas las páginas se rendericen +* Que la navigation funcione como se espera +* Que los enlaces internos se resuelvan correctamente +* Que las imágenes y los recursos se carguen correctamente +* Que los bloques de código se muestren con el resaltado de sintaxis adecuado +* Que la búsqueda funcione +* Que la implementación esté configurada +* Que el dominio personalizado esté configurado diff --git a/es/guides/monorepo.mdx b/es/guides/monorepo.mdx index bb3802f24..3f514a72f 100644 --- a/es/guides/monorepo.mdx +++ b/es/guides/monorepo.mdx @@ -4,7 +4,7 @@ description: "Despliega tu documentación desde un repositorio que contiene múl icon: "folder-git" --- -Configura Mintlify para desplegar la documentación desde un directorio específico dentro de un monorepo. Esta configuración te permite mantener la documentación junto con tu código en repositorios que contienen múltiples proyectos o servicios. +Configura Mintlify para desplegar la documentación desde un directorio específico dentro de un monorepo. Esta configuración te permite mantener la documentación junto a tu código en repositorios que contienen múltiples proyectos o servicios. @@ -19,11 +19,11 @@ Configura Mintlify para desplegar la documentación desde un directorio específ
- ## Configurar la implementación en un monorepo + ## Configurar la implementación en monorepo
- + Ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) en tu dashboard. @@ -40,7 +40,7 @@ Ve a [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-setti - + 1. Activa el interruptor **Set up as monorepo**. 2. Ingresa la ruta relativa a tu directorio de documentación. Por ejemplo, si tu documentación está en el directorio `docs`, ingresa `/docs`. diff --git a/es/guides/reverse-proxy.mdx b/es/guides/reverse-proxy.mdx index 87f9257c3..30113d79f 100644 --- a/es/guides/reverse-proxy.mdx +++ b/es/guides/reverse-proxy.mdx @@ -7,9 +7,9 @@ description: "Configura un proxy inverso personalizado para servir tu documentac Las configuraciones de proxy inverso solo están disponibles en los [planes Custom](https://mintlify.com/pricing?ref=reverse-proxy). -Para servir tu documentación mediante un proxy inverso personalizado, debes configurar reglas de enrutamiento, políticas de caché y reenvío de encabezados. +Para servir tu documentación a través de un proxy inverso personalizado, debes configurar reglas de enrutamiento, políticas de caché y reenvío de encabezados. -Al implementar un proxy inverso, supervisa posibles problemas con la verificación del domain, el aprovisionamiento de certificados SSL, los flujos de Autenticación, el rendimiento y el seguimiento de Analytics. +Cuando implementes un proxy inverso, supervisa posibles problemas con la verificación del domain, el aprovisionamiento de certificados SSL, los flujos de Autenticación, el rendimiento y el seguimiento de Analytics.
## Configuración de enrutamiento @@ -26,19 +26,19 @@ Proxy estos paths a tu subdomain de Mintlify con las políticas de caché especi | `/` | `.mintlify.app` | Sin caché |
- ## Configuración de encabezados obligatoria + ## Configuración obligatoria de encabezados
Configura tu proxy inverso con estos requisitos de encabezados: - **Origin**: Contiene el subdomain de destino `.mintlify.app` -- **X-Forwarded-For**: Conserva la información de la IP del cliente +- **X-Forwarded-For**: Conserva la IP del cliente - **X-Forwarded-Proto**: Conserva el protocolo original (HTTP/HTTPS) - **X-Real-IP**: Reenvía la IP real del cliente - **User-Agent**: Reenvía el agente de usuario - Asegúrate de que el encabezado `Host` no se reenvíe + Asegúrate de no reenviar el encabezado `Host`
@@ -126,21 +126,21 @@ server { ### Error 404
-**Síntomas**: La documentación se carga, pero las funciones no operan. Las llamadas a la API fallan. +**Síntomas**: La documentación se carga, pero las funcionalidades no funcionan. Las llamadas a la API fallan. **Causa**: Se está reenviando el encabezado `Host` o falta el encabezado `Origin`. **Solución**: -- Eliminar el reenvío del encabezado `Host` -- Establecer el encabezado `Origin` en `.mintlify.app` +- Elimina el reenvío del encabezado `Host` +- Configura el encabezado `Origin` como `.mintlify.app`
### Problemas de rendimiento
-**Síntomas**: Carga lenta de las páginas y desplazamientos del diseño. +**Síntomas**: Carga lenta de páginas y cambios en el diseño. **Causa**: Configuración de caché incorrecta. -**Solución**: Habilita la caché solo para las rutas `/mintlify-assets/_next/static/*`. \ No newline at end of file +**Solución**: Habilita el caché solo para las rutas `/mintlify-assets/_next/static/*`. \ No newline at end of file diff --git a/es/guides/windsurf.mdx b/es/guides/windsurf.mdx index d1dd59ac1..a184fda2e 100644 --- a/es/guides/windsurf.mdx +++ b/es/guides/windsurf.mdx @@ -1,10 +1,10 @@ --- title: "Windsurf" -description: "Configura Windsurf como tu asistente de escritura" +description: "Configura Windsurf como tu assistant de redacción" icon: "waves" --- -Transforma Windsurf en un especialista en documentación que entiende tu guía de estilo, tus componentes y el contexto de tu proyecto mediante reglas del espacio de trabajo y memorias. +Transforma Windsurf en un experto en documentación que entienda tu guía de estilo, tus componentes y el contexto de tu proyecto mediante reglas del espacio de trabajo y memorias. @@ -12,12 +12,12 @@ Transforma Windsurf en un especialista en documentación que entiende tu guía d ## Uso de Windsurf con Mintlify
-El assistant Cascade de Windsurf puede configurarse para redactar documentación según tus estándares utilizando componentes de Mintlify. Las reglas del espacio de trabajo y las memorias proporcionan contexto persistente sobre tu proyecto, lo que garantiza sugerencias más consistentes por parte de Cascade. +El assistant Cascade de Windsurf puede configurarse para redactar documentación según tus estándares utilizando componentes de Mintlify. Las reglas del espacio de trabajo y las memorias proporcionan contexto persistente sobre tu proyecto, lo que garantiza sugerencias más coherentes de parte de Cascade. -* **Reglas del espacio de trabajo**: se almacenan en tu repositorio de documentación y se comparten con tu equipo. -* **Memorias**: proporcionan contexto individual que se acumula con el tiempo. +* **Reglas del espacio de trabajo** se almacenan en tu repositorio de documentación y se comparten con tu equipo. +* **Memorias** proporcionan contexto individual que se acumula con el tiempo. -Recomendamos configurar reglas del espacio de trabajo para los estándares de documentación compartidos. Puedes ir creando memorias a medida que trabajas, pero como no se comparten, no serán consistentes entre los miembros del equipo. +Recomendamos configurar reglas del espacio de trabajo para unificar los estándares de documentación compartidos. Puedes desarrollar memorias conforme trabajas, pero como no se comparten, no serán coherentes entre los miembros del equipo. Crea reglas del espacio de trabajo en el directorio `.windsurf/rules` de tu repositorio de documentación. Consulta [Memories & Rules](https://docs.windsurf.com/windsurf/cascade/memories) en la documentación de Windsurf para obtener más información. @@ -33,7 +33,7 @@ Puedes usar esta regla de ejemplo tal cual o personalizarla para tu documentaci * **Estándares de redacción**: Actualiza las pautas de lenguaje para alinearlas con tu guía de estilo. * **Patrones de componentes**: Agrega componentes específicos del proyecto o modifica los ejemplos existentes. -* **Ejemplos de código**: Reemplaza los ejemplos genéricos con llamadas y respuestas reales de la API de tu producto. +* **Ejemplos de código**: Reemplaza los ejemplos genéricos con llamadas y respuestas reales de la API para tu producto. * **Preferencias de estilo y tono**: Ajusta la terminología, el formato y otras reglas. Guarda tu regla como un archivo `.md` en el directorio `.windsurf/rules` de tu repositorio de documentación. @@ -140,7 +140,7 @@ Crea una nueva página que explique cómo autenticarse con nuestra API. Incluye **Mejorar el contenido existente**: ```text wrap -Revisa esta página y sugiere mejoras para la claridad y el uso de componentes. Concéntrate en hacer que los pasos sean más fáciles de seguir. +Revisa esta página y sugiere mejoras para mayor claridad y uso de componentes. Concéntrate en hacer que los pasos sean más fáciles de seguir. ``` **Crear ejemplos de código**: diff --git a/es/image-embeds.mdx b/es/image-embeds.mdx index 7123f693d..b448ea967 100644 --- a/es/image-embeds.mdx +++ b/es/image-embeds.mdx @@ -1,10 +1,10 @@ --- -title: "Imágenes e inserciones" +title: "Imágenes y contenido incrustado" description: "Agrega imágenes, videos e iframes" icon: "image" --- -Agrega imágenes, inserta videos e incluye contenido interactivo con iframes en tu documentación. +Agrega imágenes, incrusta videos e incluye contenido interactivo con iframes en tu documentación. Fotografía de un paisaje con flores moradas en primer plano, montañas al fondo y un cielo azul con nubes dispersas. @@ -14,29 +14,29 @@ Agrega imágenes, inserta videos e incluye contenido interactivo con iframes en ## Imágenes -Agrega imágenes para aportar contexto visual, ejemplos o decoración a tu documentación. +Añade imágenes para aportar contexto visual, ejemplos o elementos decorativos a tu documentación.
### Sintaxis básica de imágenes
-Usa la [sintaxis de Markdown](https://www.markdownguide.org/basic-syntax/#images) para añadir imágenes a tu documentación: +Usa la [sintaxis de Markdown](https://www.markdownguide.org/basic-syntax/#images) para agregar imágenes a tu documentación: ```mdx ![Texto alternativo que describe la imagen](/path/to/image.png) ``` - Incluye siempre texto alternativo descriptivo para mejorar la accesibilidad y el SEO (Search Engine Optimization). El texto alternativo debe describir claramente lo que muestra la imagen. + Incluye siempre un texto alternativo descriptivo para mejorar la accesibilidad y el SEO. El texto alternativo debe describir claramente lo que muestra la imagen. -Los archivos de imagen deben pesar menos de 20 MB. Para archivos más grandes, aloja el contenido en un servicio CDN como [Amazon S3](https://aws.amazon.com/s3) o [Cloudinary](https://cloudinary.com). +Los archivos de imagen deben pesar menos de 20 MB. Para archivos más grandes, aloja las imágenes en un servicio CDN como [Amazon S3](https://aws.amazon.com/s3) o [Cloudinary](https://cloudinary.com).
### Inserciones de imágenes en HTML
-Para tener más control sobre la visualización de imágenes, usa etiquetas `` en HTML: +Para tener más control sobre la visualización de imágenes, utiliza etiquetas `` de HTML: ```html - #### Desactivar la funcionalidad de zoom + #### Desactivar la función de zoom -Para deshabilitar el zoom predeterminado al hacer clic en las imágenes, agrega la propiedad `noZoom`: +Para desactivar el zoom predeterminado al hacer clic en las imágenes, añade la propiedad `noZoom`: ```html highlight="4" -Para convertir una imagen en un enlace clicable, envuelve la imagen en una etiqueta de ancla y agrega la propiedad `noZoom`: +Para convertir una imagen en un enlace clicable, envuelve la imagen en una etiqueta de enlace y agrega la propiedad `noZoom`: ```html @@ -80,14 +80,14 @@ Para convertir una imagen en un enlace clicable, envuelve la imagen en una etiqu ``` - Las imágenes dentro de etiquetas de enlace muestran automáticamente un cursor de puntero para indicar que son clicables. + Las imágenes dentro de etiquetas de enlace muestran automáticamente el cursor de puntero para indicar que se pueden hacer clic.
#### Imágenes para los modos claro y oscuro
-Para mostrar imágenes diferentes en los temas claro y oscuro, usa clases de Tailwind CSS: +Para mostrar imágenes diferentes según el tema claro u oscuro, usa clases de Tailwind CSS: ```html @@ -112,14 +112,14 @@ Para mostrar imágenes diferentes en los temas claro y oscuro, usa clases de Tai Mintlify admite [etiquetas HTML en Markdown](https://www.markdownguide.org/basic-syntax/#html), lo que te da flexibilidad para crear contenido enriquecido. - Incluye siempre texto alternativo dentro de los elementos de vídeo para los navegadores que no admiten la reproducción de vídeo. + Incluye siempre texto alternativo dentro de los elementos de video para los navegadores que no admiten la reproducción de video.
### Inserciones de YouTube
-Inserta videos de YouTube usando elementos iframe: +Inserta videos de YouTube mediante elementos iframe: ```html