geointelmining848/escribir-ciencia-bien

Escribir Ciencia Bien

Esta habilidad destila cuatro libros sobre escritura: Strunk, Los elementos del estilo (1918/1920); Zinsser, Escribir bien (ed. 2001); Alley, El arte de la escritura científica (4.ª ed., 2018); y Heard, La guía del científico para escribir (2016). Cada regla en los archivos de referencia proviene de uno de ellos, con el autor nombrado, para que puedas sopesarla y el lector pueda verificarla. Los libros coinciden en el objetivo: una prosa tan clara que el lector nunca la note. Heard lo llama telepatía. La ley de Alley es la de Einstein: tan simple como sea posible, pero no más simple. El método de Zinsser es la resta. El de Strunk es "omitir palabras innecesarias".

Cuatro principios a los que sirve cada regla

1. El esfuerzo del lector es la única medida. Si el lector se pierde, el escritor no fue lo suficientemente cuidadoso (Zinsser). Resuelve cada pregunta de oficio preguntándote qué elección permite al lector entender la historia más fácilmente (Heard). Analiza quién lee, por qué y qué saben ya antes de elegir una palabra (Alley).
2. Di lo que quieres decir y nada de lo que no quieres decir. La precisión y la claridad tiran una contra la otra; la complejidad innecesaria es el fallo más común en la prosa científica (Alley). Atenúa exactamente según la evidencia y no inflames nada (Heard, Alley).
3. Cada palabra se gana su lugar. Una oración no debe contener palabras innecesarias, un párrafo no debe contener oraciones innecesarias (Strunk). La mayoría de los primeros borradores pueden perder la mitad de sus palabras sin perder información (Zinsser). Obliga a cada carácter a justificarse (Heard).
4. Hecho y deducción, en una línea. La escritura científica es una oración tras otra, y el "tras otra" es lo que la hace difícil (Zinsser). Una idea por oración, el actor junto a la acción, la información nueva al final (Alley, Heard, Strunk).

Las razones detrás de las reglas importan más que las reglas. Cuando una regla y el interés del lector entran en conflicto, el lector gana, y los archivos de referencia dicen por qué existe cada regla para que puedas juzgar la excepción.

Empieza aquí, cada vez

1. Nombra el modo. Redactar (producir texto nuevo), Revisar (reescribir el texto proporcionado), Diagnosticar (clasificar lo que está mal, sin reescribir) o Planificar (diseñar el documento antes de redactar). Elige el que implique la solicitud; di cuál elegiste solo si no estaba claro.
2. Fija audiencia, propósito, ocasión (Alley). Quién lee esto, por qué, qué saben y qué permite el medio en cuanto a extensión y forma. Un límite de página de una revista le da a una afirmación una oración de justificación; un informe o capítulo le da un párrafo.
3. Carga lo que necesitas, y solo eso. references/house-style.md primero, cada vez (es corto): contiene las preferencias permanentes del autor, con un conjunto inicial que el autor puede editar. Luego los archivos que el modo necesita, de la lista de lectura en el mapa de referencia a continuación. Los archivos llevan tablas de contenido; lee las secciones que toca la tarea, no todos los archivos de principio a fin.
4. Ejecuta el script de señales como máximo dos veces: una vez sobre cualquier texto proporcionado de más de un párrafo, antes de leerlo con atención, y una vez sobre tu texto final antes de entregarlo: python3 scripts/prose_signals.py <archivo> (o --json). Informa longitudes de oraciones, candidatos a pasiva, abridores expletivos, nominalizaciones, frases de relleno, atenuadores, intensificadores, "this" inicial escueto, cadenas de sustantivos, guiones largos y acrónimos de un solo uso. El encabezado dice lo que es: señales, no veredictos. Úsalo para decidir por dónde mirar primero, luego lee.
5. Decide lo que no debe cambiar. Números, afirmaciones, citas, términos definidos y, cuando el texto sea del propio autor, los giros argumentativos y la voz que protege el archivo de estilo editorial. Nunca inventes un número, una cita, un resultado o una afirmación que la fuente no contenga. Marca una laguna como ??? y enumérala.

Modo: Redactar

Redactar a partir de notas, un esquema o resultados.

1. Encuentra la historia primero. Escribe el minirresumen de dos oraciones: la pregunta central y su respuesta (Heard). Esto decide qué pertenece: ¿incluir esto ayudaría a contar la historia o distraería de ella? Para una sección de libro, indica la pregunta del lector que responde la sección y que el capítulo no responde ya (estilo editorial). Si las notas no contienen respuesta, la historia es la pregunta más el diseño, y lo dices.
2. Toma el esqueleto de references/structure.md. Una introducción se mueve del territorio a la laguna a lo que hace este trabajo, y termina en la pregunta, el enfoque y el resultado principal (Heard); la amplitud inicial la establece el medio. Un resumen es un resumen informativo que revela el resultado (Alley, Heard). Una discusión responde la pregunta en su primer párrafo y termina con el hallazgo más importante y su significado (Heard). Un capítulo comienza con una oración orientadora y mapea sus secciones (Alley, estilo editorial).
3. Decide las unidades antes de escribir (Zinsser): el pronombre, el tiempo verbal, el tono. Mantenlos hasta el final.
4. Redacta rápido, luego revisa en orden. Toma la playa con un borrador completo, con marcadores de posición para cualquier cosa que falta (Heard). Luego ejecuta las rondas de Revisar a continuación en tu propio borrador antes de entregarlo. El lector solo ve el borrador revisado.
5. Escribe solo lo que las fuentes respaldan y mantén las lagunas fuera del texto listo para pegar. No añadas una afirmación, un mecanismo o una consecuencia que las notas no contengan, incluso para puentear un argumento ("plantar vegetación puede enfriar un vecindario pero no puede aumentar sus ingresos" es una afirmación, no una transición). Puentea con los propios hechos de las notas, o deja la costura y marca la laguna en la nota; revelar una afirmación añadida no la hace admisible. Cuando las notas no contengan un resultado principal, termina una introducción con la pregunta y el enfoque (el orden que Heard nombra como alternativa) en lugar de con un marcador de posición; la nota dice lo que añadiría una oración de resultado final. Una afirmación de prioridad ("el primero en probar") mantiene su calificador ("que sepamos"), porque la búsqueda bibliográfica es lo que el análisis no puede resolver (estilo editorial: atenúa lo que genuinamente permanece sin resolver).
6. Entrega el texto en la forma solicitada (listo para pegar para prosa de manuscrito; ver Formatos de salida) más una nota corta que enumere lagunas, suposiciones y las una o dos elecciones que el autor podría querer revertir (por ejemplo "el borrador termina en el diseño; si quieres que termine en el resultado principal, añade una oración: …").

Modo: Revisar

Ajustar o aclarar texto que el usuario proporciona. Este es el modo que requiere el "se lee mal" de un coautor.

1. Lee todo el pasaje una vez para entender su historia y la intención del autor antes de tocar una palabra. Anota los puntos no negociables de "Empieza aquí".
2. Elige la escala de la edición a partir de la solicitud y di cuál elegiste. Tres casos:
   • Una solicitud para corregir una frase, o un capítulo que el autor ha terminado: revisa la frase u oración exacta, e informa solo errores fácticos o científicos en otras partes (estilo editorial).
   • Una solicitud para fortalecer, mejorar o hacer que un pasaje se lea bien, incluido el texto del propio autor: haz las tres cosas siguientes e informa cada una. Primero, la prueba de valor: nombra cualquier oración que no contenga una afirmación (una autopresentación como "Este capítulo expone por qué…", un resumen, una salvedad que no cambia ninguna afirmación, un mapa de capítulo dentro de un resumen) y propón su eliminación como un elemento reversible, con la oración citada y la razón; si mantienes dicha oración, di por qué. Segundo, el movimiento estructural que más ayudaría (una oración movida a donde sigue su consecuencia, un hallazgo enterrado traído al frente, cuatro oraciones paralelas plegadas en una), propuesto de la misma manera. Tercero, las reparaciones de frases: un conector ambiguo ("desde" por "porque"), un pronombre o "esos" sin referente claro, un verbo figurado, una frase duplicada ahora en oraciones adyacentes. "Mantener cada afirmación y término exactamente" prohíbe nuevas afirmaciones y términos renombrados; no prohíbe estas reparaciones, que no cambian ninguna afirmación. Nunca reescribas un párrafo entero solo por estilo, y mantén la voz, los términos y las afirmaciones del autor.
   • Una solicitud para ajustar un borrador: se permite reescribir, pero cada hecho, número, término y cita sobrevive sin cambios. Una revisión real de esta habilidad hizo explícito el caso intermedio: cuando se pidió un resumen "fuerte", el autor prefirió la revisión que movió una oración a la que cambió tres frases y dejó la estructura intacta.
3. Revisa en rondas de un solo propósito, en este orden (Heard, Alley), porque nunca debes pulir lo que estás a punto de cortar:
   • Contenido: corta lo que no sirve al trabajo del pasaje; verifica que la afirmación coincida con la evidencia; mantén solo los atenuadores que la evidencia necesita.
   • Estructura y párrafos: un punto por párrafo, anunciado al principio; cada oración comienza de una manera que se conecta con la anterior; el elemento nuevo e importante se sitúa al final de la oración y del párrafo (references/paragraphs.md).
   • Oraciones: actor junto a acción, verbo temprano, una idea por oración, activa a menos que la pasiva haga uno de sus tres trabajos, sin "this" escueto, sin modificador colgante, sin pronombre ambiguo (references/sentences.md).
   • Palabras: frases de relleno, nominalizaciones, intensificadores, atenuadores apilados, jerga que el lector no domina, números reportados con precisión innecesaria (references/words.md). Una abreviatura usada una vez en el pasaje se escribe completa en el texto mismo, no se deja en su lugar con una nota; si reaparece más adelante en el documento, dilo en la nota y mantén la definición.
   • Mecánica: comas después de frases introductorias, comas seriales, sin guiones largos, tiempo verbal consistente dentro de la sección, acrónimos definidos una vez.
4. Simula al lector (Heard). Lee la revisión como un desconocido que solo tiene las palabras. Léesela en voz alta en tu cabeza para los enlaces entre oraciones (Zinsser).
5. Verifica que nada se haya desviado. Cada número, unidad, intervalo, cita y término definido es idéntico a la fuente. Las afirmaciones no son ni más fuertes ni más débiles de lo que la fuente las hizo a menos que el usuario haya pedido ese cambio.
6. Entrega texto listo para pegar, una lista de cambios y, cuando cortes oraciones, una lista de cortes (ver Formatos de salida).

Modo: Diagnosticar

Hallazgos clasificados sin reescribir. También es el modo para "¿por qué está esto mal?" y "¿debería usar la pasiva aquí?": nombra la regla, el autor, la razón y un ejemplo de antes y después de los archivos de referencia.

1. Ejecuta el script; lee como el lector previsto; mantén la historia de todo el documento a la vista.
2. Clasifica los hallazgos por su costo para el lector, el contenido antes que la mecánica: la historia y la afirmación (una sobreafirmación, un límite faltante, evidencia que no respalda la interpretación, un hallazgo principal enterrado) primero; estructura (orden, posiciones de poder, enlaces faltantes, un resumen donde debería estar un final) segundo; párrafos tercero; oraciones cuarto; palabras quinto; mecánica último.
3. Escribe cada hallazgo en una forma: cita las palabras ofensivas (de cinco a doce), di qué sale mal para el lector, nombra el principio y su autor, y di qué haría una solución. Agrupa los fallos mecánicos repetidos en un solo hallazgo con un recuento.
4. Mantén todo el diagnóstico en unas 800 a 1200 palabras para una sección, y como máximo doce hallazgos. Los tres a cinco hallazgos que llevan contenido reciben un párrafo cada uno; el resto recibe una línea con un recuento y una instancia citada. Un lector que tiene que trabajar a través de dos mil palabras de hallazgos no actuará sobre ninguno de ellos. Corta la extensión de los hallazgos mecánicos, nunca de una captura sustantiva: un término que se desvía entre lo que se midió y lo que se afirma (proximidad medida, "contaminación del aire" afirmada), una afirmación hecha con dos intensidades, un hallazgo enterrado. Un acrónimo que la sección nunca define es siempre un hallazgo de una línea.
5. No reescribas a menos que te lo pidan. Si un principio no está claro sin un ejemplo, muestra una oración revisada, etiquetada como ilustración.
6. Cierra con los dos o tres cambios que más importarían, en orden.

Modo: Planificar

Diseñar un artículo, propuesta, capítulo o sección antes de redactar.

1. Audiencia, propósito, ocasión, medio y presupuesto de extensión (Alley).
2. El minirresumen de dos oraciones, luego la línea de venta: por qué la pregunta importa a este lector, no al autor (Heard). Rechaza los encuadres tímidos ("ningún estudio ha informado").
3. Baraja las figuras y tablas primero; deja que la pregunta sea implícita en las respuestas que dan (Heard). Sé reacio a superar unas cinco figuras y cuatro tablas en un artículo.
4. El esqueleto para el tipo de documento de references/structure.md, luego un esquema de oración temática: una línea por párrafo que indique su punto, en orden, con el trabajo de cada sección nombrado.
5. Marca las posiciones de poder: el primer y último párrafo de cada sección, la primera y última oración de cada párrafo, el título, los encabezados (Alley, Heard). Pon el resultado principal donde el texto borde el espacio en blanco.
6. Enumera lo que se queda fuera (la prueba triple de Heard: cuerpo, suplemento o no publicado) y los marcadores de posición que aún deben completarse.

Formatos de salida

• La prosa del manuscrito está lista para pegar: texto plano, una línea física por párrafo, sin marcadores Markdown, sin viñetas, sin numeración, sin bloques de código y sin guiones largos. El autor lo pega en Word. Cuando el texto reemplaza prosa existente, nombra el punto de destino: cita la primera y última palabra a eliminar y di si el reemplazo es una oración, un párrafo o una subsección (estilo editorial).
• La lista de cambios es corta y está agrupada: qué cambió, la regla y su autor, por qué ayuda al lector. Las trivialidades (comas, un error tipográfico) van en una línea con un recuento.
• La lista de cortes nombra cada oración eliminada y por qué se fue (repetición, metadiscurso, una salvedad que no cambió ninguna afirmación, un detalle que no podía cambiar la interpretación del lector).
• Los hallazgos (Diagnosticar) usan el formato de chat normal, clasificados.
• Una entrada .docx: extrae el texto, trabaja en él y entrega prosa lista para pegar. Los cambios controlados en el propio archivo necesitan un editor docx para…