Colay / Guías

Actualizar una base de conocimientos por lotes sin perder el control de los cambios

Cuando un cambio de producto afecta a muchos artículos y guiones de atención al cliente, el trabajo principal es coordinar la actualización. Colay puede ayudar a comparar enfoques de reescritura y redactar bloques de texto seleccionados. Un registro de cambios, una hoja informativa compartida y una cola de revisión hacen que esos borradores se puedan utilizar en un lote. Este es un flujo de trabajo editorial administrado, no una conexión automática que actualiza su base de conocimientos en segundo plano.

Haga un inventario del contenido afectado antes de generar texto

Comience con el cambio de producto y busque en su contenido existente el término, regla o procedimiento anterior. Registre identificadores de artículos, macros de soporte, mensajes de incorporación e instrucciones internas que puedan mencionarlo. No asuma que títulos similares significan contenido idéntico o que un modelo conoce cada lugar donde aparece la redacción anterior.

Cree una hoja de cambios aprobada con el comportamiento anterior, el comportamiento nuevo, la fecha de vigencia, las excepciones y la terminología exacta. Asignar un responsable para hechos no resueltos. Separe las actualizaciones fácticas de la limpieza de estilo opcional, para que una oración más bonita no oculte un cambio de política. Para el texto de procedimiento, la guía de Google favorece pasos de acción claros y un contexto explícito; aplique el mismo estándar en todo el lote.

Utilice un registro que siga cada elemento hasta su publicación

Imagínese un servicio ficticio que cambia la ubicación de su control de exportación. La nueva ruta aprobada es Informes → Exportar; los permisos y los formatos de salida siguen siendo los mismos. Su inventario incluye un artículo instructivo, una lista de verificación de incorporación y una respuesta de soporte. Estas entradas ilustrativas no describen la interfaz de Colay.

Los elementos necesitan diferentes ediciones: una instrucción completa puede requerir una nueva captura de pantalla, una lista de verificación necesita un cambio de etiqueta y el guion de atención al cliente puede necesitar solo una ruta corregida. Generar ocho reescrituras completas de cada elemento generaría trabajo de revisión sin mejorar necesariamente la actualización.

Ejemplo de registro por lotes para un cambio de interfaz ficticio
ArtículoCambio requeridoRevisar evidenciaEstado
KB-12 guía de exportaciónActualizar la ruta y la captura de pantallaRecorrido por la exportación con el rol indicadoBorrador pendiente de revisión
ON-4 lista de verificación de incorporaciónReemplazar la antigua ubicación de controlConsulta la guía vinculada y la etiqueta visibleListo para revisión del responsable
SUP-7 respuesta guardadaCorregir una instrucciónPrueba la respuesta comparándola con una pregunta de muestraNo iniciado

Calibrar en una pequeña muestra representativa

Ocho formas de reescribir pueden resultar útiles durante la calibración: procedimiento conciso, explicación para principiantes, solución de problemas, preguntas frecuentes, respuesta de soporte, lista de verificación interna, lenguaje sencillo centrado en la accesibilidad y breve resumen. Elija los formatos que el inventario realmente necesita. El resultado útil es una regla de edición coherente, no ocho versiones competitivas de cada página.

  1. Elija un artículo simple, un artículo con excepciones y un guion de atención al cliente. Redactelos antes de procesar el resto del inventario.
  2. Proporcione a los agentes Colay disponibles la misma hoja de cambios y solicite enfoques de edición alternativos. Compare si conservan todas las reglas sin cambios.
  3. Aprobar un patrón de edición y una lista de terminología. Mantenga ejemplos de cambios aceptados y rechazados al lado del resumen del lote.
  4. Trabaje manualmente a través de grupos de contenido manejables, preservando cada identificador de elemento y su versión fuente. Detenga el lote cuando aparezca una nueva contradicción.

Un mensaje para un artículo de lote rastreable

Proporcione únicamente material permitido para este uso y omita detalles innecesarios del cliente. Mantenga el registro autorizado en su documento o sistema de contenido existente. La respuesta generada por Colay no actualiza por sí misma el estado de publicación del elemento.

Actualice el elemento de contenido [ID y versión fuente] utilizando esta hoja de cambios aprobada: [comportamiento anterior, comportamiento nuevo, fecha de vigencia, excepciones]. Texto existente: [texto]. Terminología aprobada y patrón de edición: [reglas]. Devuelva el texto revisado, una lista de pasajes modificados con los motivos, las reglas sin cambios que usted conservó y las preguntas que bloquean la publicación. Modifique solo el contenido afectado. Conserve los enlaces e identificadores a menos que el informe los cambie explícitamente. No invente nuevas etiquetas de interfaz de usuario, permisos, fechas o comportamientos de productos. Si este elemento entra en conflicto con la hoja de cambios, marque el conflicto en lugar de resolverlo mediante conjeturas.

Publicar en grupos revisados y conservar una forma de volver atrás

Antes de publicar, verifique cada instrucción, excepción y enlace modificados con la fuente aprobada y el producto real. Revise el documento completo sobre las ediciones: un párrafo corregido aún puede entrar en conflicto con una introducción sin cambios. Registre al aprobador y conserve la versión anterior del contenido.

Publique a través de sus herramientas existentes, luego verifique el artículo publicado y cualquier respuesta guardada que enlace a él. Marque un elemento como completo solo después de esa verificación. Realice un seguimiento del tiempo editorial transcurrido y de las correcciones encontradas después de la publicación si desea evaluar el proceso. Un flujo de trabajo por lotes puede reducir la repetición de sesiones informativas, pero el resultado depende del contenido y del esfuerzo de revisión; no promete ahorrar una semana automáticamente.

Preguntas y respuestas

¿Puedo cargar toda la base de conocimientos y actualizarla automáticamente?

Este artículo describe la redacción manual y controlada con Colay. No pretende tener un conector automático de base de conocimientos, un editor por lotes ni una sincronización en segundo plano.

¿Qué tamaño debe tener un lote?

Utilice un grupo lo suficientemente pequeño como para que el revisor pueda comparar cada elemento afectado con la hoja de cambios. Reduzca su tamaño cuando las reglas o los formatos de contenido difieran.

¿Qué pasa si dos artículos fuente se contradicen?

Detenga esos elementos y pregunte al responsable del contenido o del producto qué regla tiene autoridad. Mantenga el conflicto en el registro para que una reescritura fluida no lo oculte.

Fuentes y metodología

  1. Google: writing procedures

    Guía de redacción primaria para los pasos de acción y el contexto; el registro de lotes y el flujo de trabajo de lanzamiento son recomendaciones editoriales originales.

Envíe su próxima pregunta a Colay

Elija un modelo, utilice Auto o reúna varias perspectivas con Consensus.

Planificar mi actualización