- Todos los desarrolladores escriben bien código, pero para convertirse en mejores ingenieros necesitan mejorar sus habilidades de escritura
¿Por qué escribir?
- Escribir es una forma de ordenar la mente
- Escribir es una forma de aprender algo
- Escribir ayuda a encontrar errores
¿Cómo escribir más?
- Algo para recordar: leer es un hábito y escribir es una habilidad
- Para dominar una habilidad, hay que escribir más
- Una de las formas más simples de escribir más es abordar las revisiones de diseño de otra manera
- En vez de odiarlas y hacerlas como si fueran tarea, hazlas con entusiasmo
- Cada vez que escribas una revisión de diseño, intenta mejorar algo
- Intenta escribir más corto sin perder los puntos clave, y también escribir más largo para cubrir más casos de uso
- Si quieres mejorar tu escritura fuera del trabajo, intenta empezar un blog
- Si un blog te resulta pesado, intenta responder preguntas en Stackoverflow. No copies código; enfócate en aportar contenido de texto
- El último consejo es: no hagas Copy & Paste.
- El problema es que todos solo copian comandos de GitHub/Google
- Si te preocupa volverte menos productivo, recuerda que el criterio de evaluación no es cuántas líneas de código escribes ni qué tan rápido terminas las tareas
- Escribir no se puede evitar. Te guste o no, para convertirte en un ingeniero 10x tienes que escribir
- "Escriban documentación, escriban revisiones de diseño y creen presentaciones. Cuanto mejor se vuelvan escribiendo, más rápido podrán convertirse en mejores ingenieros."
1 comentarios
Google Technical Writing para ingenieros [en inglés]
Los 4 principios del technical writing
Los 10 mandamientos del technical writing para desarrolladores
Principios para completar el technical writing de forma limpia