mintlify__docs/es/optimize/feedback.mdx

---
title: "Comentarios"
description: "Monitorea la satisfacción de los usuarios con widgets de retroalimentación integrados, calificaciones de páginas y reacciones de pulgar arriba/abajo para identificar áreas de mejora."
keywords: ["user feedback","thumbs rating","contextual feedback","satisfaction"]
---

<Info>
  Para recopilar y ver comentarios, debes habilitar los comentarios desde la página de [Add-ons](https://dashboard.mintlify.com/products/addons) en tu dashboard.
</Info>

La pestaña [Feedback](https://dashboard.mintlify.com/products/analytics/v2/feedback) muestra los votos cuantitativos de pulgar hacia arriba y pulgar hacia abajo que ha recibido tu documentación, así como cualquier comentario cualitativo que hayan proporcionado los usuarios. Usa esta información para evaluar la calidad de tu documentación y realizar mejoras.

Consulta los comentarios en la página de Analytics en tu dashboard.

<Frame>
  <img
    className="block dark:hidden"
    src="/images/analytics/feedback-light.png"
    alt="Pestaña Feedback en la página de Analytics."
  />
  <img
    className="hidden dark:block"
    src="/images/analytics/feedback-dark.png"
    alt="Pestaña Feedback en la página de Analytics."
  />
</Frame>

<div id="feedback-types">
  ## Tipos de comentarios
</div>

<Note>
  Los comentarios contextuales y sobre fragmentos de código están en versión beta. Para habilitarlos en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:hahnbee@mintlify.com).
</Note>

La pestaña de comentarios muestra información según los [Add-ons de comentarios](https://dashboard.mintlify.com/products/addons) que habilites.

<Frame>
  <img className="block dark:hidden" src="/images/analytics/feedback-addons-light.png" alt="Controles de comentarios en la página Add-ons." />

  <img className="hidden dark:block" src="/images/analytics/feedback-addons-dark.png" alt="Controles de comentarios en la página Add-ons." />
</Frame>

- **Valoración con pulgares**: Votación simple de pulgar arriba/abajo para medir la satisfacción general con las páginas.
- **Sugerencias de edición**: Permite que los usuarios sugieran ediciones para tu documentación. Solo disponible para repositorios públicos de GitHub.
- **Crear issues**: Permite que los usuarios creen issues de GitHub directamente desde tu documentación. Solo disponible para repositorios públicos de GitHub.
- **Comentarios contextuales**: Comentarios abiertos sobre el contenido de una página.
- **Comentarios sobre fragmentos de código**: Comentarios específicamente sobre fragmentos de código.

<div id="collect-email-addresses">
  ## Recopilar direcciones de correo electrónico
</div>

Habilita la recopilación de correos electrónicos para que los usuarios puedan proporcionar opcionalmente su dirección de correo electrónico al enviar comentarios.

1. Ve a la página de [Add-ons](https://dashboard.mintlify.com/products/addons) en tu dashboard.
2. Habilita la opción **Collect reader emails** en la configuración de comentarios.
3. Opcionalmente, añade un aviso de privacidad sobre cómo tu equipo utiliza los correos electrónicos recopilados.

Consulta las direcciones de correo electrónico enviadas con los comentarios en el [dashboard de comentarios](https://dashboard.mintlify.com/products/analytics/v2/feedback) junto al contenido de los comentarios.

<Note>
  Si deshabilitas la telemetría en tu archivo `docs.json`, las funciones de comentarios no estarán disponibles en tus páginas de documentación.
</Note>

<div id="manage-feedback">
  ## Gestionar comentarios
</div>

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 los comentarios de los usuarios.

<div id="change-feedback-status">
  ### Cambiar el estado de los comentarios
</div>

Selecciona el estado junto a un comentario para marcarlo como **Pendiente**, **En curso**, **Resuelto** o **Descartado**.

Mejores prácticas para definir estados de comentarios:

- **Pendiente**: El comentario está a la espera de revisión.
- **En curso**: Se está trabajando para resolver el comentario.
- **Resuelto**: El comentario se ha resuelto.
- **Descartado**: El comentario es irrelevante o inexacto.

<div id="filter-by-status">
  ### Filtrar por estado
</div>

Utiliza el menú **Filters** para controlar qué comentarios se muestran. Quita un estado para ocultar todos los comentarios con ese estado. De forma predeterminada, se muestran todos los tipos de comentarios.

<div id="filter-by-type">
  ### Filtrar por tipo
</div>

Selecciona entre **Ratings by page**, **Detailed feedback** y **Code snippets** según la información que deseas analizar.

- **Ratings by page**: Consulta qué páginas tienen más comentarios positivos y negativos. Usa estos datos cuantitativos para identificar las páginas que los usuarios consideran más y menos útiles.
- **Detailed feedback**: Revisa los comentarios abiertos que los usuarios dejan en las páginas para identificar mejoras específicas en páginas concretas.
- **Code snippets**: Revisa los comentarios abiertos que los usuarios dejan sobre fragmentos de código para identificar mejoras específicas en bloques de código concretos.

<div id="add-internal-notes">
  ### Añadir notas internas
</div>

Haz clic en un elemento de feedback para añadir una nota interna. Estas notas solo son visibles para las personas con acceso a tu dashboard.

Usa las notas para añadir información para colaborar, vincular tickets relevantes de soporte o de ingeniería, o recordar cualquier otra información útil.

<div id="use-feedback-data">
  ## Usa los datos de feedback
</div>

Revisa tus datos de feedback para:

- **Identificar contenido exitoso**: Las páginas con más feedback positivo muestran qué funciona bien en tu documentación.
- **Priorizar mejoras**: Las páginas con más feedback negativo indican qué contenido podría necesitar atención.
- **Tomar medidas**: Realiza actualizaciones en la documentación basadas en el feedback directo de los usuarios.