# Guía editorial · español de Colombia

## Destinatarios y tono

La web acompaña a personas que pueden comenzar sin experiencia con IA. Háblales de **tú** con instrucciones concretas: «abre una copia», «comprueba el cálculo», «registra lo que falta». En instrumentos dirigidos al instructor, usa **usted** de manera consistente. Evita cambiar de tratamiento dentro de una misma explicación.

Busca una redacción profesional, respetuosa y cercana. La elegancia está en la claridad y la precisión: usa palabras comunes y verbos concretos para que el texto se sienta cuidado, natural y fácil de seguir. Evita sonar rígido, solemne o artificial; no uses adornos, muletillas, elogios automáticos, frases prefabricadas ni coloquialismos forzados. Ajusta la formalidad al propósito y a quien va a leer.

Escribe primero qué se quiere lograr; después, cómo hacerlo y cómo comprobar el resultado. Expresa una idea principal por oración y, en textos largos, por párrafo. Usa transiciones, listas y negritas solo cuando ayuden a orientarse. Lee el texto en voz alta antes de publicarlo y cambia cualquier frase que no suene natural. Explica las siglas en su primera aparición. Prefiere «instrucción» cuando no sea necesario el término técnico *prompt* y «revisión humana» cuando describa quién decide.

## De la solicitud al contenido

Parte de la intención de la solicitud: identifica qué necesita comprender o hacer el aprendiz y redacta para ese propósito. Usa las instrucciones recibidas como criterios de trabajo; no copies sus palabras por inercia ni conviertas cada requisito en una frase repetida. Una petición de claridad se resuelve con una explicación comprensible y un ejemplo pertinente.

## Aclaraciones sobre los datos de práctica

Aclara una sola vez, al comienzo del recorrido y antes de la primera práctica, que los casos y archivos se prepararon para aprender y no contienen registros reales. Después, llama a cada elemento por su nombre y evita anteponer «ficticio» o «sintético» a personas, tareas y resultados en cada sección. Repite la aclaración dentro de un archivo que pueda descargarse y leerse por separado, o junto a un ejemplo sensible o una instrucción que pueda confundirse con autorización para cargar datos reales. Conserva esas palabras cuando formen parte del nombre de una fuente, un archivo, un campo o un marcador técnico.

Haz que cada sección aporte información nueva. El título orienta, la entrada explica el propósito, los pasos guían la acción y el ejemplo muestra el resultado. El cierre propone una comprobación concreta. Si dos párrafos cumplen la misma función, reúne su aporte o elimina uno. Repetir una advertencia tiene sentido cuando cambia el riesgo o cuando el aprendiz debe tomar una decisión en ese punto.

Varía la construcción de las oraciones y usa verbos que correspondan a la acción: localizar un apartado, contrastar una afirmación, calcular una tasa o registrar una propuesta. No cambies términos precisos solo para buscar sinónimos: una solicitud, una reserva y una aprobación describen cosas distintas. Conserva nombres de archivos, etiquetas, conceptos y datos que la persona necesite reconocer.

Elimina rodeos como «en relación con la solicitud, se solicita» y explica directamente qué falta, quién debe actuar o cómo continuar. Evita comenzar todos los párrafos con la misma fórmula y anunciar lo que la siguiente frase ya muestra. Un español más rico se consigue con ideas bien desarrolladas, ejemplos y un ritmo variado; no necesita palabras rebuscadas ni adornos.

Después de editar, haz una lectura completa: revisa si las ideas se conectan, si cada instrucción tiene un propósito y si el resultado conserva hechos, pendientes y límites. Los ejemplos de redacción deben mostrar qué mejora y por qué, sin presentar una frase de estilo como una regla inflexible.

## Términos y hechos que deben coincidir

| Tema | Forma de uso |
| --- | --- |
| Sede propuesta | Centro de Gestión Agroempresarial del Oriente (CGAO), Subsede Vélez, Regional Santander. Fechas y ambiente siguen por confirmar. |
| Duración de esta propuesta | 36 horas directas y 4 autónomas: 40 horas en cuatro jornadas. La ficha publicada indica 48 horas; la propuesta necesita validación curricular. |
| Actividades | Diez retos breves (0 a 9), un integrador y cinco evidencias (MG-A01 a MG-A05). La cartilla original contiene siete retos; la web añade 0, 7 y 9. |
| Evaluación | El instructor registra Aprobado (A) o No Aprobado (NA). «Lista para entregar» solo describe el diligenciamiento. |
| Datos | Declara una vez al inicio que los materiales son de práctica y no contienen registros reales. Los borradores no se envían ni equivalen a una aprobación institucional. |
| Léxico | «Computador», «archivo», «hacer clic», «portafolio de evidencias», «aprendiz» e «instructor». Respeta nombres oficiales de aplicaciones y archivos. |

## Revisión antes de cerrar

1. Lee cada página completa en el orden en que la recorre el aprendiz. Verifica que el título, los pasos, el ejemplo y la evidencia pidan la misma tarea.
2. Comprueba cantidades, sumas, nombres de hojas, referencias y enlaces contra la web y los archivos de práctica. Mantén las reservas: propuesta, dato confirmado o asunto pendiente.
3. Corrige tildes, concordancia, puntuación, verbos vagos y repeticiones. Si una frase admite dos interpretaciones, reescríbela con sujeto y acción explícitos.
4. Comprueba que el texto suene profesional y cercano, sin rigidez, adornos ni fórmulas automáticas. La edición debe conservar la intención, los hechos y el nivel de certeza.
5. Ejecuta `npm run check:redaccion` y `npm test`. El verificador marca expresiones conocidas; una lectura editorial sigue siendo indispensable.

Los documentos históricos conservan su contexto de origen. Su aviso inicial debe remitir con claridad a la guía vigente y no presentar el material antiguo como instrucciones de esta cohorte.