Permite a los miembros de la comunidad sugerir ediciones a las publicaciones, lo que brinda a los revisores un control granular sobre qué cambios aceptar, sin otorgar permisos de edición completos.
El plugin es experimental y está sujeto a muchos cambios en este momento, aún no es para uso en producción.
GitHub - discourse/discourse-suggested-edits: EXPERIMENTAL suggested edits plugin · GitHub
Instalación
Siga la guía estándar de instalación de plugins utilizando la URL del repositorio:
https://github.com/discourse/discourse-suggested-edits.git
¿Por qué ediciones sugeridas?
Muchas comunidades quieren que los miembros ayuden a mantener el contenido preciso y actualizado, pero otorgar acceso de edición a todos no siempre es práctico. Suggested Edits (Ediciones Sugeridas) cierra esta brecha: los miembros pueden proponer mejoras a las publicaciones y los revisores de confianza deciden qué se aplica. Piense en ello como traer un modelo de contribución estilo Wikipedia a su comunidad de Discourse.
Esto es especialmente útil para:
- Categorías de base de conocimiento y documentación donde la precisión importa y muchos ojos ayudan
- Comunidades con miembros más nuevos que tienen buenas contribuciones pero aún no han obtenido la confianza de edición completa
- Contenido colaborativo como preguntas frecuentes, guías o referencias mantenidas por la comunidad
- Ediciones automatizadas: a veces, los sistemas de IA pueden sugerir correcciones de errores tipográficos y de voz, y usted necesita que un humano apruebe
Cómo funciona
Sugerir una edición
Los miembros del grupo de sugerencias configurado ven un botón “Sugerir edición” en las publicaciones elegibles. Hacer clic en él abre el compositor precargado con el contenido de la publicación. Hacen sus cambios, opcionalmente agregan una razón y envían.
Revisar sugerencias
Los revisores ven una insignia de recuento en las publicaciones con sugerencias pendientes. Hacer clic en “Revisar” abre una ventana modal que desglosa la sugerencia en cambios individuales, cada uno mostrado como una diferencia resaltada con el contexto circundante.
Los revisores pueden:
- Aceptar o rechazar cada cambio de forma independiente: no es necesario tomarlos todos o ninguno
- Editar el texto sugerido antes de aplicarlo: ajuste la redacción mientras conserva la intención
- Cambiar entre las vistas de diff en línea y lado a lado
- Navegar entre múltiples sugerencias si hay más de una pendiente
Aplicar cambios
Cuando el revisor hace clic en “Aplicar aceptados”, los cambios seleccionados se aplican a la publicación como una revisión atribuida a quien sugirió, con una razón de edición que indica quién la aprobó. Se notifica al autor de la sugerencia y a cualquier otro usuario afectado.
Manejo de desactualización
Si la publicación original se edita después de que se crea una sugerencia, la sugerencia se marca automáticamente como desactualizada y no se puede aplicar. Esto evita conflictos y garantiza que las sugerencias siempre se basen en el contenido actual. Se notifica a los autores de la sugerencia para que puedan reenviarla si es necesario.
Configuración
Habilite el plugin y configure el acceso en Admin > Configuración, buscando “suggested edits” (ediciones sugeridas):
| Configuración | Descripción |
|---|---|
suggested_edits_enabled |
Interruptor maestro para el plugin |
suggested_edits_suggest_groups |
Grupos cuyos miembros pueden sugerir ediciones |
suggested_edits_review_groups |
Grupos cuyos miembros pueden revisar y aplicar sugerencias. Los autores de las publicaciones siempre pueden revisar las sugerencias en sus propias publicaciones. |
suggested_edits_included_categories |
Categorías donde se habilitan las ediciones sugeridas |
suggested_edits_included_tags |
Etiquetas en temas donde se habilitan las ediciones sugeridas |
suggested_edits_max_creates_per_minute |
Límite de velocidad para crear sugerencias (predeterminado: 5) |
suggested_edits_max_revisions_per_minute |
Límite de velocidad para revisar sugerencias (predeterminado: 10) |
Una configuración típica
- Habilitar el plugin
- Establecer grupos de sugerencia en el nivel de confianza o grupo que deba poder proponer ediciones (p. ej.,
trust_level_1) - Establecer grupos de revisión en sus moderadores o curadores (p. ej.,
staff) - Elegir las categorías o etiquetas donde desea habilitarlo; no tiene que activarlo en todas partes
Los autores de las publicaciones siempre pueden revisar las sugerencias en sus propias publicaciones, independientemente de la configuración del grupo de revisión.
Alcance y limitaciones
- Solo las primeras publicaciones: las ediciones sugeridas actualmente se aplican a las primeras publicaciones de los temas (OP), no a las respuestas
- Una sugerencia pendiente por usuario por publicación: un miembro debe esperar a que se resuelva su sugerencia actual antes de enviar otra en la misma publicación
- Las sugerencias se basan en texto: la diferencia se calcula sobre el contenido Markdown sin procesar de la publicación
Búsqueda
Los revisores pueden usar el filtro de búsqueda with:suggested-edits para encontrar temas con sugerencias pendientes en todo el foro.