Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 34 additions & 21 deletions es/api-playground/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,9 @@ Personaliza tu área de pruebas de la API definiendo las siguientes propiedades
</ResponseField>

<ResponseField name="proxy" type="boolean" defaultOpen="True">
Indica si las solicitudes de API deben pasar por un servidor proxy. El valor predeterminado es `true`.
Indica si las solicitudes de API deben pasar por el servidor proxy de Mintlify. El valor predeterminado es `true`.

Cuando es `true`, las solicitudes del área de pruebas se enrutan a través de los servidores de Mintlify. Cuando es `false`, el área de pruebas envía las solicitudes directamente desde el navegador a tu API. Establécelo en `false` cuando tu API acepte solicitudes directas desde el navegador y no necesites que Mintlify actúe como proxy del tráfico. Por ejemplo, cuando tu API requiere encabezados específicos que no pueden reenviarse a través del proxy o cuando necesitas que la solicitud se origine directamente desde el navegador del usuario con fines de autenticación.
</ResponseField>
</Expandable>
</ResponseField>
Expand All @@ -115,26 +117,26 @@ Personaliza tu área de pruebas de la API definiendo las siguientes propiedades
Se muestran en el orden especificado.

<Accordion title="All supported languages">
| Nombre visible | Clave | Alias |
| --- | --- | --- |
| cURL | `bash` | `curl`, `sh`, `shell` |
| Python | `python` | `py` |
| JavaScript | `javascript` | `js` |
| Node.js | `node` | `nodejs`, `node.js` |
| PHP | `php` | |
| Go | `go` | `golang` |
| Java | `java` | |
| Ruby | `ruby` | `rb` |
| PowerShell | `powershell` | |
| Swift | `swift` | |
| C# | `csharp` | `c#` |
| .NET | `dotnet` | `.net`, `.NET`, `dot-net` |
| TypeScript | `typescript` | `ts` |
| C | `c` | |
| C++ | `c++` | `cpp` |
| Kotlin | `kotlin` | `kt` |
| Rust | `rust` | `rs` |
| Dart | `dart` | `flutter` |
| Nombre visible | Clave | Alias |
| -------------- | ------------ | ------------------------- |
| cURL | `bash` | `curl`, `sh`, `shell` |
| Python | `python` | `py` |
| JavaScript | `javascript` | `js` |
| Node.js | `node` | `nodejs`, `node.js` |
| PHP | `php` | |
| Go | `go` | `golang` |
| Java | `java` | |
| Ruby | `ruby` | `rb` |
| PowerShell | `powershell` | |
| Swift | `swift` | |
| C# | `csharp` | `c#` |
| .NET | `dotnet` | `.net`, `.NET`, `dot-net` |
| TypeScript | `typescript` | `ts` |
| C | `c` | |
| C++ | `c++` | `cpp` |
| Kotlin | `kotlin` | `kt` |
| Rust | `rust` | `rs` |
| Dart | `dart` | `flutter` |
</Accordion>
</ResponseField>

Expand Down Expand Up @@ -224,6 +226,17 @@ Se recomienda la extensión `x-mint` para que toda la documentación de tu API s

Las páginas MDX individuales se recomiendan para APIs pequeñas o cuando quieras experimentar con cambios página por página.

<div id="response-rendering">
## Visualización de respuestas
</div>

El playground renderiza automáticamente las respuestas según el encabezado `Content-Type` que devuelve tu API.

* **Imágenes**: Se renderizan en línea (`image/*`).
* **Audio**: Se renderiza con un reproductor de audio integrado (`audio/*`).
* **Video**: Se renderiza con un reproductor de video integrado (`video/*`). Cualquier respuesta con un tipo de contenido `video/*`, como `video/mp4` o `video/webm`, se muestra como un video reproducible directamente en el playground.
* **Todas las demás respuestas**: Se muestran en un bloque de código.

<div id="further-reading">
## Más información
</div>
Expand Down
32 changes: 16 additions & 16 deletions es/deploy/authentication-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,12 @@ keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password']
</Info>

<Warning>
La autenticación solo está disponible para documentación alojada en un dominio personalizado o subdominio de Mintlify (por ejemplo, `docs.ejemplo.com` o `ejemplo.mintlify.dev`). La autenticación **no es compatible** cuando se usa una [ruta base personalizada](/es/deploy/docs-subpath) (por ejemplo, `ejemplo.com/docs`).
La autenticación solo está disponible para documentación alojada en un dominio personalizado o subdominio de Mintlify (por ejemplo, `docs.example.com` o `example.mintlify.dev`). La autenticación **no es compatible** cuando se usa una [ruta base personalizada](/es/deploy/docs-subpath) (por ejemplo, `example.com/docs`).
</Warning>

La autenticación exige que los usuarios inicien sesión antes de acceder a tu documentación.

Cuando habilites la autenticación, los usuarios deberán iniciar sesión para acceder a cualquier contenido. Puedes configurar páginas o grupos específicos como públicos mientras mantienes otras páginas protegidas.
Cuando habilites la autenticación, los usuarios deberán iniciar sesión para acceder a cualquier contenido. Puedes configurar páginas específicas o groups como públicos mientras mantienes otras páginas protegidas.

<div id="configure-authentication">
## Configurar la autenticación
Expand Down Expand Up @@ -489,19 +489,19 @@ Cuando utilices autenticación OAuth o JWT, tu sistema devolverá datos de usuar
</ParamField>

<div id="feature-availability">
## Disponibilidad de funciones
## Disponibilidad de funcionalidades
</div>

Algunas funciones se comportan de manera diferente o no están disponibles cuando habilitas la autenticación.

| Función | Público | Totalmente autenticado (todas las páginas protegidas) | Parcialmente autenticado (algunas páginas públicas) |
| :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos |
| [Servidor MCP](/es/ai/model-context-protocol) | Compatibilidad completa | Requiere autenticación para conectarse | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas |
| [Exportación a Markdown](/es/ai/markdown-export) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios |
| [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad completa | No compatible | No compatible |
| [Búsqueda](/es/ai/assistant) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios |
| [Assistant](/es/ai/assistant) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios |
| [skill.md](/es/ai/skillmd) | Compatibilidad completa | No compatible | No compatible |
| [Mapa del sitio](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad completa | Disponible tras autenticación, pero excluye las páginas en groups | Disponible tras autenticación, pero excluye las páginas en groups |
| [robots.txt](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad completa | Disponible tras autenticación | Disponible tras autenticación |
Algunas funcionalidades se comportan de forma distinta o no están disponibles cuando habilitas la autenticación.

| Funcionalidad | Público | Autenticación completa (todas las páginas protegidas) | Autenticación parcial (algunas páginas públicas) |
| :----------------------------------------------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| [llms.txt y llms-full.txt](/es/ai/llmstxt) | Compatibilidad total | Disponibles con autenticación, por lo que es posible que las herramientas de IA no puedan acceder a estos archivos | Disponibles con autenticación, por lo que es posible que las herramientas de IA no puedan acceder a estos archivos |
| [servidor MCP](/es/ai/model-context-protocol) | Compatibilidad total | Requiere autenticación para conectarse | Disponible sin autenticación para las páginas públicas y con autenticación para las páginas protegidas |
| [Exportación en Markdown](/es/ai/markdown-export) | Compatibilidad total | Compatibilidad total, respeta los grupos de usuarios | Compatibilidad total, respeta los grupos de usuarios |
| [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad total | No compatible | No compatible |
| [Búsqueda](/es/ai/assistant) | Compatibilidad total | Compatibilidad total, respeta los grupos de usuarios | Compatibilidad total, respeta los grupos de usuarios |
| [Assistant](/es/ai/assistant) | Compatibilidad total | Compatibilidad total, respeta los grupos de usuarios | Compatibilidad total, respeta los grupos de usuarios |
| [skill.md](/es/ai/skillmd) | Compatibilidad total | No compatible | No compatible |
| [Mapa del sitio](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad total | Disponible con autenticación, pero excluye las páginas de los grupos | Disponible con autenticación, pero excluye las páginas de los grupos |
| [robots.txt](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad total | Disponible con autenticación | Disponible con autenticación |
8 changes: 6 additions & 2 deletions es/guides/maintenance.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,13 @@ keywords: ["maintenance", "content lifecycle", "stale content"]

Introduce automatizaciones cuando sea posible, como:

* **Detecta contenido obsoleto:** Ejecuta un script para señalar la documentación importante que no se haya actualizado en los últimos tres meses. ¿Sigue siendo precisa?
* **Haz seguimiento del contenido obsoleto:** Ejecuta un script para marcar con una **opción** la documentación importante que no se haya actualizado en los últimos tres meses. ¿Sigue siendo precisa?
* **Automatiza las actualizaciones de la documentación:** Crea un flujo de trabajo para actualizar automáticamente la documentación cuando se fusione código con la [API del agente](/es/guides/automate-agent).
* **Aplica estándares con linters:** Usa [Vale](http://Vale.sh) o [verificaciones de CI](/es/deploy/ci) para detectar automáticamente problemas de formato, desviaciones de estilo de redacción o metadata faltante en cada solicitud de extracción.
* **Aplica estándares con linters:** Usa [Vale](http://Vale.sh) o [verificaciones de CI](/es/deploy/ci) para detectar automáticamente problemas de formato, desviaciones del estilo de redacción o metadatos faltantes en cada solicitud de extracción.

<Tip>
Usa [workflows](/es/agent/workflows) para automatizar tareas de mantenimiento recurrentes, como aplicar guías de estilo, verificar metadatos o redactar registros de cambios.
</Tip>

<div id="set-up-a-review-process">
## Configura un proceso de revisión
Expand Down
16 changes: 10 additions & 6 deletions es/guides/seo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ keywords: ["search engine optimization", "meta tags", "keyword research"]
---

<Tip>
Esta página explica estrategias fundamentales para optimizar el SEO de tu documentación.
Esta página explica estrategias fundamentales para optimizar el SEO de tu documentación.
</Tip>

<div id="content-basics">
Expand All @@ -22,13 +22,17 @@ Facilita que los motores de búsqueda exploren tu redacción y estructura.
## Conceptos básicos de SEO técnico
</div>

Una vez que tu contenido esté optimizado, asegúrate de que tu documentación rinda bien desde el punto de vista técnico.
Una vez que tu contenido esté optimizado, asegúrate de que tu documentación funcione bien desde el punto de vista técnico.

Estas prácticas básicas de SEO técnico ayudan a que tu documentación sea más fácil de encontrar:
Estas prácticas básicas de SEO técnico ayudan a que tu documentación sea más fácil de descubrir:

* **Metatags y descripciones:** Redacta títulos optimizados para SEO (50–60 caracteres) y descripciones (150–160 caracteres) para cada página. La mayoría de los [metatags](/es/optimize/seo) se generan automáticamente.
* **Texto alternativo para imágenes:** Incluye texto alternativo descriptivo en las imágenes con palabras clave relevantes. Por ejemplo, “flujo de autenticación de API con OAuth 2.0” en lugar de solo “diagrama”. Esto mejora el SEO y la accesibilidad.
* **Sitemaps:** Asegúrate de que tu sitemap esté actualizado. Mintlify genera automáticamente un sitemap. No obstante, puedes crear uno manualmente si prefieres un formato personalizado. Una vez creado, los motores de búsqueda lo indexan con el tiempo, pero puedes enviar tu sitemap directamente a Google Search Console para acelerar el proceso.
* **Meta tags y descripciones:** Redacta títulos optimizados para SEO (50-60 caracteres) y descripciones (150-160 caracteres) para cada página. La mayoría de los [meta tags](/es/optimize/seo) se generan automáticamente.
* **Texto alternativo para imágenes:** Proporciona texto alternativo descriptivo para las imágenes con palabras clave relevantes. Por ejemplo, &quot;flujo de autenticación de API con OAuth 2.0&quot; en lugar de solo &quot;diagrama&quot;. Esto mejora el SEO y la accesibilidad.
* **Sitemaps:** Asegúrate de que tu sitemap esté actualizado. Mintlify genera automáticamente un sitemap. Sin embargo, puedes crear un sitemap manualmente si prefieres un formato personalizado. Una vez creado, los motores de búsqueda indexan los mapas del sitio con el tiempo, pero puedes enviar tu sitemap directamente a Google Search Console para acelerar el proceso.

<Tip>
Usa un [flujo de trabajo](/es/agent/workflows) para ejecutar una auditoría semanal de SEO que verifique metadatos faltantes o deficientes y abra una solicitud de extracción con mejoras.
</Tip>

<div id="page-performance">
## Rendimiento de la página
Expand Down
14 changes: 9 additions & 5 deletions es/guides/style-and-tone.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,13 +22,13 @@ keywords: ["principios de redacción", "voz activa", "redacción técnica", "gu
## Errores comunes de redacción
</div>

- **Errores ortográficos y gramaticales.** Incluso unos pocos errores ortográficos y gramaticales en tu documentación la hacen menos creíble y más difícil de leer.
- **Terminología inconsistente.** Llamar algo “API key” en un párrafo y luego “token de API” en el siguiente dificulta que los usuarios puedan seguir la explicación.
- **Terminología centrada en el producto.** Tus usuarios no tienen todo el contexto de tu producto. Usa un lenguaje con el que tus usuarios estén familiarizados.
- **Expresiones coloquiales.** Especialmente en localización, las expresiones coloquiales perjudican la claridad.
* **Errores ortográficos y gramaticales.** Incluso unos pocos errores ortográficos y gramaticales en tu documentación la hacen menos creíble y más difícil de leer.
* **Terminología inconsistente.** Llamar algo “API key” en un párrafo y luego “token de API” en el siguiente dificulta que los usuarios puedan seguir la explicación.
* **Terminología centrada en el producto.** Tus usuarios no tienen todo el contexto de tu producto. Usa un lenguaje con el que tus usuarios estén familiarizados.
* **Expresiones coloquiales.** Especialmente en localización, las expresiones coloquiales perjudican la claridad.

<div id="tips-for-enforcing-style">
## Consejos para aplicar el estilo
## Sugerencias para aplicar el estilo
</div>

Aprovecha guías de estilo existentes para estandarizar tu documentación:
Expand All @@ -39,6 +39,10 @@ Aprovecha guías de estilo existentes para estandarizar tu documentación:

Cuando tengas claros los principios de redacción que quieres implementar, automatiza todo lo que puedas. Puedes usar [verificaciones de CI](/es/deploy/ci) o linters como [Vale](https://vale.sh).

<Tip>
Usa un [workflow](/es/agent/workflows) para ejecutar una auditoría de estilo de forma programada o cada vez que se envíen cambios a tu repositorio de documentación, a fin de corregir automáticamente las infracciones y señalar cualquier aspecto que requiera una revisión adicional.
</Tip>

<div id="related-pages">
## Páginas relacionadas
</div>
Expand Down
Loading
Loading