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

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.