mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
90a6653b5c
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
149 lines
6.5 KiB
Plaintext
149 lines
6.5 KiB
Plaintext
---
|
|
title: "Registro de cambios"
|
|
description: "Crea registros de cambios del producto con compatibilidad con RSS para suscriptores."
|
|
keywords: ["actualizaciones de producto", "notas de lanzamiento", "RSS"]
|
|
---
|
|
|
|
Crea un registro 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.
|
|
|
|
<div id="setting-up-your-changelog">
|
|
## Configurar tu página de cambios
|
|
</div>
|
|
|
|
<Steps>
|
|
<Step title="Crea una página para tu registro de cambios">
|
|
1. Crea una nueva página en tu documentación, por ejemplo `changelog.mdx` o `updates.mdx`.
|
|
2. Añade tu página de cambios al esquema de navigation en tu `docs.json`.
|
|
</Step>
|
|
|
|
<Step title="Añade componentes Update a tu registro de cambios">
|
|
Añade un `Update` para cada entrada del registro.
|
|
|
|
Incluye información relevante como lanzamientos de funcionalidades, correcciones de errores u otros anuncios.
|
|
</Step>
|
|
</Steps>
|
|
|
|
```mdx Example changelog.mdx
|
|
---
|
|
title: "Cambios"
|
|
description: "Actualizaciones del producto y anuncios"
|
|
---
|
|
<Update label="March 2025" description="v0.0.10">
|
|
Se agregó un nuevo sabor Wintergreen.
|
|
|
|
Se lanzó una nueva versión del sabor Spearmint, ahora con 10% más menta.
|
|
</Update>
|
|
|
|
<Update label="February 2025" description="v0.0.09">
|
|
Se lanzó una nueva versión del sabor Spearmint.
|
|
</Update>
|
|
```
|
|
|
|
<div id="customizing-your-changelog">
|
|
## Personalizar tu página de cambios
|
|
</div>
|
|
|
|
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.
|
|
|
|
<div id="table-of-contents">
|
|
### Tabla de contenidos
|
|
</div>
|
|
|
|
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.
|
|
|
|
<Frame>
|
|
<img src="/images/changelog-toc-light.png" alt="Página de cambios con la tabla de contenidos mostrada en modo claro." className="block dark:hidden" />
|
|
|
|
<img src="/images/changelog-toc-dark.png" alt="Página de cambios con la tabla de contenidos mostrada en modo oscuro." className="hidden dark:block" />
|
|
</Frame>
|
|
|
|
<div id="tag-filters">
|
|
### Filtros por etiquetas
|
|
</div>
|
|
|
|
Agrega `tags` a tus componentes `Update` para reemplazar la tabla de contenido con filtros por etiquetas. Los usuarios pueden filtrar los cambios seleccionando una o varias etiquetas:
|
|
|
|
```mdx Tag filters example wrap
|
|
<Update label="Marzo 2025" description="v0.0.10" tags={["Wintergreen", "Spearmint"]}>
|
|
Se agregó un nuevo sabor Wintergreen.
|
|
|
|
Se lanzó una nueva versión del sabor Spearmint, ahora con 10% más menta.
|
|
</Update>
|
|
|
|
<Update label="Febrero 2025" description="v0.0.09" tags={["Spearmint"]}>
|
|
Se lanzó una nueva versión del sabor Spearmint.
|
|
</Update>
|
|
|
|
<Update label="Enero 2025" description="v0.0.08" tags={["Peppermint", "Spearmint"]}>
|
|
Se marcó como en desuso el sabor Peppermint.
|
|
|
|
Se lanzó una nueva versión del sabor Spearmint.
|
|
</Update>
|
|
```
|
|
|
|
<Frame>
|
|
<img src="/images/changelog-filters-light.png" alt="Registro de cambios en modo claro con el filtro de etiqueta Peppermint seleccionado." className="block dark:hidden" />
|
|
|
|
<img src="/images/changelog-filters-dark.png" alt="Registro de cambios en modo oscuro con el filtro de etiqueta Peppermint seleccionado." className="hidden dark:block" />
|
|
</Frame>
|
|
|
|
<Tip>
|
|
La tabla de contenidos y los filtros del registro de cambios se ocultan al usar los modos de página `custom`, `center` o `wide`. Más información sobre los [modos de página](/es/organize/pages#page-mode).
|
|
</Tip>
|
|
|
|
<div id="subscribable-changelogs">
|
|
### Registros de cambios a los que te puedes suscribir
|
|
</div>
|
|
|
|
<Note>Los feeds RSS solo están disponibles en la documentación pública.</Note>
|
|
|
|
Usa componentes `Update` para crear un feed RSS al que te puedas suscribir en la URL de tu página con `/rss.xml` añadido. Por ejemplo, `mintlify.com/docs/changelog/rss.xml`.
|
|
|
|
El feed RSS publica entradas cuando agregas nuevos componentes `Update` y cuando modificas los encabezados dentro de componentes `Update` existentes.
|
|
|
|
Las entradas del feed RSS contienen únicamente Markdown puro. Los componentes, el código y los elementos HTML se excluyen. Usa la propiedad `rss` para proporcionar descripciones de texto alternativas para los suscriptores del RSS cuando tus actualizaciones incluyan contenido que queda excluido.
|
|
|
|
```xml Example RSS feed
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
|
|
<channel>
|
|
<title><![CDATA[Actualizaciones del producto]]></title>
|
|
<description><![CDATA[Nuevas actualizaciones y mejoras]]></description>
|
|
<link>https://mintlify.com/docs</link>
|
|
<generator>RSS for Node</generator>
|
|
<lastBuildDate>Mon, 21 Jul 2025 21:21:47 GMT</lastBuildDate>
|
|
<atom:link href="https://mintlify.com/docs/changelog/rss.xml" rel="self" type="application/rss+xml"/>
|
|
<copyright><![CDATA[Mintlify]]></copyright>
|
|
<docs>https://mintlify.com/docs</docs>
|
|
<item>
|
|
<title><![CDATA[Junio 2025]]></title>
|
|
<link>https://mintlify.com/docs/changelog#june-2025</link>
|
|
<guid isPermaLink="true">https://mintlify.com/docs/changelog#june-2025</guid>
|
|
<pubDate>Mon, 23 Jun 2025 16:54:22 GMT</pubDate>
|
|
</item>
|
|
</channel>
|
|
</rss>
|
|
```
|
|
|
|
Los feeds 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:
|
|
|
|
* [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) mediante Zapier
|
|
* Bots de Discord como [Readybot](https://readybot.io) o [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot)
|
|
|
|
Para que el feed RSS sea fácil de descubrir, puedes mostrar un botón con el icono RSS que enlace al feed en la parte superior de la página. Agrega `rss: true` al frontmatter de la página:
|
|
|
|
```mdx
|
|
---
|
|
rss: true
|
|
---
|
|
```
|
|
|
|
<Frame>
|
|
<img src="/images/changelog-rss-button-light.png" alt="Página de cambios en modo claro con el botón RSS habilitado." className="block dark:hidden" />
|
|
|
|
<img src="/images/changelog-rss-button-dark.png" alt="Página de cambios en modo oscuro con el botón RSS habilitado." className="hidden dark:block" />
|
|
</Frame>
|