mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
ce2388e32e
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
102 lines
4.5 KiB
Plaintext
102 lines
4.5 KiB
Plaintext
---
|
|
title: "Comentarios"
|
|
description: "Supervisa la satisfacción de los usuarios y sus comentarios sobre tu documentación."
|
|
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.
|
|
* **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.
|
|
* **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.
|
|
|
|
<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**: 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, relevante o por ser inexacto.
|
|
|
|
<div id="filter-by-status">
|
|
### Filtrar por estado
|
|
</div>
|
|
|
|
Utiliza el filtro por estado para controlar qué comentarios se muestran. Quita un estado para ocultar todos los comentarios con ese estado. De forma predeterminada, se muestran todos los comentarios.
|
|
|
|
<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. |