Made in DeveloperHub
Recopile comentarios de sus lectores directamente desde las páginas.
Para asegurarse de que su documentación sea de alta calidad, esté actualizada y ofrezca a sus lectores la información que necesitan, es de gran importancia recopilar los comentarios de sus lectores. DeveloperHub lleva los comentarios de sus lectores a las páginas y procesa los datos por usted en el panel, para que pueda mejorar la documentación y tener lectores más satisfechos.
¿Cómo funcionan los comentarios para los lectores?
Cuando está habilitado, al final de cada página aparece una pregunta que indica si la página fue útil. El lector puede responder con un Sí o un No, y a continuación puede aparecer una solicitud para añadir un mensaje que explique su opinión.
¿Dónde puedo encontrar los comentarios recibidos?
Los comentarios pueden consultarse en dos niveles: página y proyecto. Cuando una página recibe un me gusta o un no me gusta, puede ver la valoración media de la página en la barra lateral derecha. También puede ver el registro de valoraciones a lo largo del tiempo, así como los mensajes que ha recibido esa página. Puede marcar el mensaje como leído.
Además, en el panel también puede ver la valoración del proyecto a lo largo del tiempo, así como todos los mensajes sin leer. Asimismo, en el panel encontrará una lista de las páginas con más me gusta y de las páginas con menos me gusta. Puede usar esta información para aplicar el buen estilo de documentación de las páginas con más me gusta a las páginas con menos me gusta, y analizar los mensajes para aprender a mejorar las páginas.
También puede descargar los comentarios como CSV desde el panel, con la opción de descarga junto a Feedback Inbox.
Junto a ella, Analyse with AI envía los comentarios a AI Agent. El agente comienza con una solicitud para leer lo que a los lectores les gustó y lo que no, encontrar los temas comunes y señalar las páginas que mejorar, lista para que la envíe. Requiere un plan con funciones de IA, el agente activado para el proyecto y acceso de escritor o superior.
Cualquier miembro del equipo puede marcar un comentario como spam. Los comentarios marcados como spam se minimizan en el panel de comentarios. Los comentarios de spam no aparecen en la barra lateral de comentarios de una página. No cuentan en ninguna estadística ni se envían a través de nuestros canales de notificación. También puede usar un filtro de spam automático.
Notificaciones de comentarios
Si tiene un canal de Slack conectado a su proyecto, le notificaremos en ese canal de Slack los comentarios que haya recibido.
Enviamos las notificaciones cada hora.
Filtro de spam de comentarios
El filtro de spam de comentarios está deshabilitado de forma predeterminada y se puede habilitar desde Feedback Settings.
El filtro de spam marca como spam cualquier comentario recién enviado cuyo mensaje parezca inútil, sospechoso, spam, demasiado corto, malicioso u ofensivo.
Cuando la opción está habilitada, cualquier comentario nuevo que contenga un mensaje se enviará a OpenAI para el filtrado de spam.
Los controles de comentarios también pueden mostrarse u ocultarse según el sitio de referencia (el sitio desde el que el lector ha llegado a la documentación). Esto puede ser útil si los lectores confunden su sitio con el sitio de soporte de su propio cliente B2B. Por ejemplo, los controles de comentarios pueden deshabilitarse según el sitio de referencia añadiendo el siguiente Custom JS:
Se puede hacer lo mismo para configurar una lista de denegación de sitios de referencia.
Eliminar información personal de los comentarios
La información de identificación personal (PII) puede eliminarse de los comentarios automáticamente. Está deshabilitada de forma predeterminada y se puede habilitar desde Feedback Settings.
El filtro de PII eliminará cualquier información que parezca personal de los mensajes de comentarios a medida que se envían, como nombres, números de teléfono, direcciones de correo electrónico, direcciones físicas, etc.
La PII no se puede recuperar una vez eliminada.
Cuando la opción está habilitada, cualquier comentario nuevo que contenga un mensaje se enviará a OpenAI para eliminar la PII.
Configuración de comentarios
Toda la configuración de comentarios está en un solo lugar: Project Settings → General → Feedback. Cambie lo que necesite allí y luego haga clic en Save changes en el menú superior.
En Reader feedback:
Collect feedback coloca el widget de reacciones al pie de cada página publicada. Está activado de forma predeterminada en los proyectos creados después de abril de 2021.
Written messages permite a los lectores explicar el motivo con sus propias palabras en lugar de solo reaccionar. Requiere que Collect feedback esté activado, porque el cuadro de mensaje se muestra dentro del widget, y requiere un plan que incluya mensajes escritos. Consulte Pricing.
En AI moderation:
Redact personal information elimina correos electrónicos, números de teléfono y nombres de un mensaje antes de almacenarlo.
Flag spam marca los envíos basura para que no estorben a los comentarios reales.
Ambas opciones de moderación requieren que Written messages esté activado, porque una reacción no contiene texto que eliminar o clasificar, y ambas requieren un plan que incluya funciones de IA.
Desactivar cualquiera de estas opciones siempre está permitido, sea cual sea su plan. Si su proyecto conserva una opción de un plan que ya dejó, aún puede volver a desactivarla.
Hook de JavaScript para comentarios
Si desea enviar analíticas de búsqueda a servicios de terceros, puede usar el evento de JavaScript onfeedback para escuchar los eventos de comentarios. Consulte On Feedback.