Para recopilar y ver comentarios, primero debes habilitar la función de comentarios en la página de Add-ons de tu panel.
La pestaña de comentarios 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. Accede a la pestaña de comentarios desde la página de Analytics en tu panel.

​
Tipos de feedback

El feedback contextual y sobre fragmentos de código está en beta. Para habilitarlos en tu sitio de documentación, contacta a nuestro equipo de ventas.
La pestaña de feedback muestra información según los complementos de feedback que habilites. Activa los tipos de feedback que prefieras:
Captura de pantalla de los toggles de feedback en la página Add-ons.
  • Solo valoración con pulgares: Votación simple de pulgar arriba/abajo para medir la satisfacción general con las páginas.
  • Solo feedback sobre fragmentos de código: Feedback específicamente sobre fragmentos de código.
  • Valoración con pulgares y feedback contextual: Votación de la página más comentarios detallados y motivos de las valoraciones.
  • Valoración con pulgares y feedback sobre fragmentos de código: Votación de la página más feedback sobre ejemplos de código.
  • Valoración con pulgares, contextual y feedback sobre fragmentos de código: Sistema de feedback completo con votación de la página, comentarios detallados y feedback sobre fragmentos de código.

​
Gestión de comentarios

Para comentarios contextuales y sobre fragmentos de código, puedes establecer el estado de cada comentario y añadir notas internas para hacer seguimiento de tu trabajo al resolver el feedback de los usuarios.

​
Cambiar el estado del feedback

Selecciona el estado junto a un feedback para marcarlo como Pendiente, En progreso, Resuelto o Descartado. Mejores prácticas para configurar estados de feedback:
  • Pendiente: El feedback está en 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 accionable, por irrelevante o por inexacto.

​
Filtrar por estado

Usa el filtro de estado para controlar qué feedback se muestra. Desmarca un estado para ocultar todo el feedback con ese estado. De forma predeterminada, se muestra todo el feedback.

​
Agregar notas internas

Haz clic en un comentario para agregar una nota interna. Estas notas solo son visibles para las personas con acceso a tu panel. 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.

​
Uso de los datos de comentarios

Revisa tus datos de comentarios para:
  • Identificar contenido exitoso: 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.