¡Los ingenieros de software deben escribir!

Todos los ingenieros de software son buenos escritores… de código. Pero creo que para convertirte en un mejor ingeniero, debes mejorar tus habilidades de escritura. Esto es lo que sugiere Dmitri Kudryavtsev, Ingeniero de software sénior.

Desde el «principio» de los tiempos el ser humano ha estado escribiendo. 

— Bueno, desde que se inventó alguna forma de escritura… 

Hemos escrito usando símbolos, como en el Antiguo Egipto; hemos escrito con letras, como en la época del Renacimiento. Y todos fuimos obligados a hacer tareas escritas en cuadernos, en muchos casos, tanto en la escuela como en niveles superiores. 

— Pero nadie, probablemente, nos explicó el porqué. 

Y hoy en día la escritura está tan subestimada que muchos quieren evitarla… Pero la verdad es que tendrán que escribir, como mínimo, comentarios, documentación general, documentos de diseño, presentaciones, ensayos, etc. ¡Te guste o no!

— Entonces, ¿por qué no mejorar la habilidad de escribir?

Primer punto: Escribir es una forma de organizar tus ideas

Por alguna razón, muchos piensan que el conocimiento viene a través de la lectura. 

• «He leído la guía de inicio de Rust, así que ahora conozco este tema». 
• «Leí un libro sobre cómo funciona TCP/IP, así que ahora sé esto».

Pero eso no es verdad. Si fuera cierto, todos seríamos superestrellas.

— «Lo que nos ayuda a cimentar nuestro conocimiento es la acción de escribir. Es por eso que creo, por ejemplo, en escribir código, en lugar de copiar fragmentos de él. Porque cuando lo escribo, consolido ese conocimiento».

Segundo punto: Escribir es una manera de aprender 

— «Si quieres aprender un tema nuevo, escribe sobre él». 

• Cuando quieras aprender un nuevo lenguaje de programación, escribe un programa usando ese lenguaje de programación. 

• Cuando quieras entender cómo funciona algo, escribe un artículo al respecto y publícalo o compártelo para que sea validado y cuestionado. 

La escritura real, en la que intentas “desenterrar” la verdad, requerirá que pruebes y experimentes. 

— «He aprendido más escribiendo artículos en diferentes blogs que leyendo libros de programación».

Tercer punto: Escribir te ayuda a identificar errores

Cuántas veces nos piden que elaboremos un documento de diseño, a lo que respondemos: ¿para qué? 

— «El diseño es tan simple que puedo mantenerlo en mi cabeza fácilmente». Este es un gran error en el que todos - o casi todos - caemos. 

Si escribiéramos el documento de diseño, ¡habríamos identificado tantos problemas en nuestro diseño “simple”!: inconsistencias, detalles faltantes o simplemente pensamientos “vagos” de nuestro cerebro, que en realidad no tienen sentido.

Leer es un hábito, escribir es una habilidad

— «Y para perfeccionar tu habilidad, necesitas escribir más». 

Una forma sencilla de escribir más es abordar las revisiones de diseño de manera diferente. En lugar de odiarlos y hacerlos como una tarea, trata de acercarte a ellos con entusiasmo. 

• Cada vez que escribas una verificación de diseño, intente mejorar algo. Hazlo más corto, sin perder el punto. Hazlo más largo para cubrir más casos de uso. Agrega valor al documento. 

• Escribir revisiones de diseño y documentación, en su lugar de trabajo, es una manera fácil de comenzar a escribir. Tendrás que hacerlo de todos modos, así que, ¿por qué no mejorar mientras escribes? 

Sin embargo, si deseas mejorar aún más su escritura, fuera de su sitio de trabajo, considera iniciar, por ejemplo, un blog. Si escribir un blog es intimidante para ti, considera responder preguntas en Stackoverflow, pero concéntrate en proporcionar contenido textual, en lugar de copiar y pegar fragmentos de código.

Para finalizar…

Un consejo de vital importancia: ¡abandona de una vez por todas la práctica de copiar y pegar!

Es común observar a desarrolladores cayendo en la tentación de copiar y pegar sin medida. Aunque esto puede parecer una solución rápida, en realidad es un hábito perjudicial que va más allá del ámbito del código, afectando diversos aspectos del trabajo.

La habilidad de escribir y redactar adecuadamente es un elemento esencial para el crecimiento profesional y el éxito en esta industria. Aquellos que aspiran a ser ingenieros 10x deben comprender que la calidad de su trabajo no solo se mide en la eficiencia del código, sino también en la claridad de sus comunicaciones y documentación.

Al dominar la escritura y redacción, no solo se evitan problemas derivados de errores de copia, sino que se fomenta un proceso más profundo de aprendizaje y comprensión. La capacidad de expresar ideas de manera clara y concisa, más allá de la calidad del código, es una habilidad que se traduce en mejores colaboraciones, una comunicación más efectiva y un mayor impacto en los proyectos.

---

Fuente: https://www.yieldcode.blog/post/why-engineers-should-write/