- Al entrar a una nueva empresa, una de las primeras cosas que hizo fue comprar una libreta nueva, y esto no nacía solo de la alegría, sino de la idea de que era una herramienta clave como desarrollador
- Programar es solo la etapa final; lo más importante es el proceso de pensar qué construir y cómo hacerlo, y muchas veces eso empieza en una libreta, no en la computadora
- Visualizar el pensamiento en la libreta con texto y dibujos ayuda a concretar ideas abstractas y también deja al descubierto vacíos de conocimiento, lo que favorece un mejor diseño
- El hábito de explicar por escrito el código que uno mismo escribió mientras lo revisa funciona como una herramienta efectiva de refactorización para detectar inconsistencias o diseños equivocados
- Estos registros también son útiles para el yo del futuro como material para reconstruir el contexto de las decisiones, y terminan siendo una especie de documento de retrospectiva automatizado
Por qué el bolígrafo y la libreta son lo más importante
- Una de las cosas que más esperaba antes de su primer día de trabajo era elegir una libreta nueva
- Para un desarrollador, una libreta no es solo una herramienta para tomar apuntes, sino una herramienta para pensar
- Programar es la ejecución al final del pensamiento, y el proceso de reflexionar sobre qué construir es más importante
- En muchos casos, frente a la computadora el pensamiento creativo no fluye bien
- Al abrir el editor, uno entra en un “modo funcional” en el que solo se concentra en el “código que funciona”
Pensar lejos de la computadora
- Sale a caminar o se lleva una libreta al sofá o al exterior para pensar en el problema
- Organiza en la libreta el diseño del enfoque para un problema nuevo, bocetos de UI, diagramas de flujo, así como análisis del flujo de datos del código existente e ideas para ampliar funciones
- La visualización del pensamiento mediante texto y dibujos es extraordinariamente efectiva para volver concretas las ideas ambiguas
- Los vacíos lógicos que en la mente se omiten rápidamente aparecen con claridad al escribir
Escribir es la mejor herramienta de refactorización
- Después de escribir código, tiene el hábito de redactarlo como si se lo explicara a otra persona
- Si es posible lo publica en un blog, pero incluso en formato de documentación interna, el proceso de explicarlo permite descubrir inconsistencias, malos diseños y errores
- Post relacionado: Escribir en un blog es mi nueva herramienta favorita de refactorización
Subproducto del pensamiento y activo documental
- Otra ventaja de pensar escribiendo es que las huellas del razonamiento quedan registradas de forma natural
- Aunque no se documente por separado, el subproducto de ordenar las ideas se convierte en un excelente material de retrospectiva
- Más adelante, si alguien (especialmente tu yo del futuro) pregunta “por qué se hizo así”, basta con abrir la libreta y explicarlo tal cual
Sobre cómo tomar notas como desarrollador de forma más profunda
1 comentarios
Opiniones de Hacker News
Siento que esta es una gran discusión. Para mí, el punto clave no es la libreta ni la herramienta digital en sí, sino que cambian el engranaje de mi cerebro. Cada vez que cambio de modo, mi atención funciona distinto, así que un nuevo contexto mejora la concentración, la creatividad y la memoria. Por ejemplo, después de pasarme todo el tiempo programando, empecé a escribir por las noches como hobby nuevo, y sentí como si mi cerebro se reiniciara; de verdad mejoró mi rendimiento durante el día. Cuando planeo algo, cambiar por un rato de lo digital a pluma y papel también rompe la rutina y hace que mi cerebro funcione de otra manera. Al final, lo importante no es la herramienta, sino despertar mediante el cambio
Me pregunto cuántos desarrolladores de hoy habrán tomado a la fuerza una clase básica de dibujo técnico. Seguro muchos jugaron con LEGO. Cuando necesitas explicar un objeto 3D en una hoja 2D, normalmente tienes que dibujar proyecciones desde tres direcciones, y si es más complejo que eso, necesitas verlo desde más ángulos para poder explicarlo
Me impactó el concepto de "disfluency" que conocí en el libro 'Smarter Faster Better'. Una tipografía incómoda, un entorno nuevo o herramientas distintas te sacan del piloto automático y te obligan a pensar de nuevo. Nunca vi este concepto en otro lado, pero en los últimos 9 años cambió por completo mi forma de abordar la resolución de problemas y el aprendizaje. Para mí, cambiar a la libreta también funciona como un muy buen disparador de ese efecto
En mi caso, de hecho tomo notas en tres medios: una libreta de papel, una grabadora antigua y archivos de texto. Cada medio tiene ventajas y desventajas únicas, así que las ideas también se expresan de forma distinta. La grabadora se usa cada vez menos, pero cuando no hay tiempo y necesito avanzar rápido, es ideal. Cuando vuelvo a escuchar la grabación y la reescribo, cada repetición transforma la idea de una manera diferente. Ese proceso me permite ver la misma idea desde varios ángulos
Según una investigación que escuché hace tiempo, el cambio de contexto cuesta en promedio unos 15 minutos. No sé qué tan exacto sea, pero mis jefes también le dan mucha importancia y lo respetan bastante
Yo lo experimenté mientras seguía una serie de webinars en vivo y tomaba apuntes al instante con pluma y papel. Al principio era muy difícil seguir el ritmo, pero después de unos días me fui volviendo mejor en ese cambio entre escuchar y escribir, y sentí que retenía mejor la información auditiva
Algunas de las personas más inteligentes que he conocido en matemáticas, física y ciencias de la computación ni siquiera usan cuadernos. En vez de eso, escriben con pluma sobre papel de impresora y luego simplemente lo tiran. Casi nunca he encontrado algo útil en notas personales de hace mucho tiempo. Lo realmente importante es documentarlo para que otros también puedan encontrarlo, y lo que de verdad haya que memorizar, aprenderlo con flashcards y spaced repetition. Claro, ese es mi método y puede que no le sirva a otros. El título de este post solo busca compartir la filosofía de un desarrollador, no decir que todo el mundo deba seguirla. Si la pluma y la libreta no te funcionan, no tienes por qué usarlas
Desde un punto de vista científico, escribir algo mejora la memoria, la memorización y la capacidad de aprendizaje. Incluso si tiras lo que escribiste de inmediato, el efecto sigue ahí. También hay un artículo relacionado. Escribir a mano activa más sentidos y más áreas del cerebro (en particular la corteza motora) que teclear. Yo también uso esto como excusa para querer comprar un Moleskine, pero la escritura a mano no encaja con mi flujo de trabajo. Yo tecleo grandes cantidades en un buffer de texto plano y luego las proceso con un LLM como GPT. Cuando mi mente se bloquea, incluso si escribo a lo loco palabras que no entiendo, poco a poco vuelvo a arrancar, y de ahí salen listas de tareas, borradores de correo o borradores de código. En ese proceso, la mayoría de los garabatos iniciales desaparecen. Aun así, escribir a mano sí ayuda más a la memoria
Estoy de acuerdo con la idea de que las notas viejas no sirven para mucho. Pero igual sigo guardando esas notas y papeles. Verlos después de mucho tiempo se siente como mirar fotos familiares antiguas, como fotos de mi antiguo proceso de pensamiento
Mi cerebro también funciona así. Sí tengo notas, pero un día entero de pensamientos cabe en una sola página. Al día siguiente, escribo en la siguiente. Casi nunca vuelvo a revisar lo anterior. Tal vez haya algo de valor en mirar al pasado, pero en la práctica no lo hago
Para mí, el método de tomar notas solo funciona si es totalmente libre y sin estructura. Con el teclado es difícil capturar el flujo. Lo hago para registrar datos no lineales, no verbales, relacionales, espaciales o información para la memoria de corto plazo. Reviso periódicamente mis notas y paso lo que vale la pena a sistemas de registro como calendario, tickets, wiki o spaced repetition. Al final, muy poco merece conservarse, pero no importa. El cuaderno de papel no es mi sistema oficial de registro; es una extensión de mi memoria de trabajo
Antes solía perder mis notas con frecuencia. Ahora uso herramientas tecnológicas para pasarlas a texto y organizarlas en mi vault de Obsidian. En el futuro me gustaría probar formas de explorar automáticamente conexiones entre notas o etiquetarlas para encontrar ideas con más facilidad
Llamar a la libreta la "herramienta más importante" es demasiado romántico. Puede ser útil para algunas personas, pero decir que es más importante que un debugger, el control de versiones o CI es una exageración. La ingeniería de software no es cosplay de artesanía
Soy el OP. Cada vez que mi blog llega a HN, siempre aparece alguien diciendo que "vive en una fantasía" o que es "romanticismo puro". Las herramientas que mencionaste, por supuesto, son importantes. Desarrollar sin control de versiones o sin debugger sería ineficiente, así que yo también lo evitaría. Pero para mí, la libreta de verdad es más importante. Las herramientas para escribir y ejecutar código son solo eso: herramientas para hacer que el trabajo ocurra. Lo realmente importante en el desarrollo de software es crear algo valioso y resolver problemas. Ahí, el código en sí no pasa de ser una etapa menor de implementación. Pensar qué construir y cómo construirlo es mucho más importante. Algunas personas pueden pensar mejor en el editor de código o con herramientas digitales. Yo, si solo estoy en el editor, me meto demasiado en los detalles de implementación y me cuesta imaginar la estructura general. Por eso, para mí es absolutamente clave llevar una libreta y usarla antes y después de programar. Si no tuviera esa herramienta, mi capacidad de pensar, resolver problemas y ser creativo se volvería mucho peor, y terminaría haciendo mal software
Lo que tú describes no es ingeniería de software, sino manufactura de software. La diferencia entre un blue collar y un white collar está justamente en esa actitud frente a las "herramientas". Para un ingeniero, una regla de cálculo, una calculadora o una supercomputadora no son más que herramientas. Uno no hace ingeniería por la herramienta. La esencia es el pensamiento, y la herramienta solo facilita el proceso. Para quien manufactura, en cambio, la máquina lo es todo. Sin la máquina, no hay widgets. La esencia no es la "producción", sino el "pensamiento"
Es como decir: "Claro que al construir una casa el martillo es más importante que el plano. Esto no es una clase de arte, es una obra de construcción"
Gracias por señalarlo. Pasa lo mismo con la gente que invierte muchísimo tiempo en sistemas de productividad, llenando notas de GTD con pestañas y listas, pero sin hacer trabajo realmente productivo. Mucha gente escribe sobre su workflow de Obsidian, pero en realidad no deja notas significativas. También hay quienes se pasan todo el tiempo construyendo su blog y nunca escriben de verdad. (Yo también fui así). La frase "esto no es cosplay de artesanía, es ingeniería de software" me encantó; la voy a anotar
Me encanta la expresión "craftsmanship cosplay". Me gustaría ver datos sobre puesto, carrera, edad, ingresos y educación de cada persona que comenta. Da la impresión de que las opiniones revelan más sobre quien las emite que sobre el desarrollo de software exitoso en sí. El OP simplemente encontró una forma que le funciona para concentrarse y ser creativo. Tomar el artículo o las críticas como si fueran un estándar es un error. Imitar patrones así termina siendo poco diferente de un comportamiento cargo cult
Parece que la mayoría de los comentarios se enfocan en la parte física de "pluma y papel", pero están perdiendo el verdadero principio central. El autor usa pluma y papel porque, cuando se sienta frente a la computadora, cambia automáticamente a "modo implementación" y se enfoca más en implementar que en diseñar. O sea, lo importante es no caer simplemente en la implementación cuando necesitas diseño, sino elegir por tu cuenta cómo mantener ese equilibrio
Esto al final pertenece al terreno de la productividad personal. Hay que experimentar con varios métodos y descubrir el entorno y el proceso que mejor le sirvan a cada quien. La pluma y el papel ayudan a orientar el pensamiento y el diseño sin caer en detalles excesivos ni distraerse. Yo también a veces alterno entre ideas pensadas con pluma y papel e ideas escritas directamente en Sublime Text, y ambos me funcionan bastante bien
Le queda perfecto el meme de la curva de campana que circula en Reddit, donde los dos extremos usan la misma solución y el "promedio" se queja. El OP dio en el clavo: piensa antes de programar. Ahora que mi carrera ya casi termina (empecé en el 88 y llevo décadas en esto), una de las cosas más interesantes ha sido ver cómo cambian las herramientas. Soy senior principal software architect en una empresa grande, y no escribo ni una sola línea de código. Todos mis entregables los hago en Visio, Word, PowerPoint (a veces PlantUML). Cuanto más sube el nivel de abstracción, más simples se vuelven las herramientas. La arquitectura que diseño termina funcionando por más de 10 años en sistemas militares, médicos y de proveedores automotrices Tier 1. El código que realmente se implementa (mayormente C, C++, antes Ada, y quizá Rust en el futuro) o el lenguaje no afectan en absoluto a la arquitectura. Lo que de verdad importa son los bloques, las API y la encapsulación. Eso es lo que impacta en silicio, seguridad, producción y pruebas. Lo esencial es lo que puede explicarse en unas cuantas diapositivas, no el código en sí. (Claro, mis diagramas también tienen que resistir el descubrimiento de defectos de diseño. Esa es otra parte divertida)
Leuchturm 1917 A4 Master notebook (recomiendo muchísimo el dot grid). La calidad es excelente y usarlo con una pluma fuente da muchísimo gusto. El tamaño A4 es grande, así que también sirve para meter hojas sueltas, y para diseño de UI en particular el A4 tiene un tamaño ideal
Llevo más de 20 años creando software, y antes de eso hice doctorado e investigación en química orgánica. Gano lo suficiente como "senior" en Australia. Tengo aphantasia (incapacidad de imaginar imágenes mentalmente), así que uso muchísimo pluma y papel o pizarrón. Hago ERD, mapas mentales, diagramas de secuencia y otras visualizaciones. Uso ReMarkable porque facilita mover contenido y me ha hecho más eficiente. A algunas personas esto puede parecerles "romanticismo puro", pero en mi caso la pluma y el papel fueron esenciales para mi éxito
Después de intentar crear el hábito de organizarme con distintas herramientas y apps de notas, este año como propósito de Año Nuevo compré un bloc de To-Do con fecha y empecé a usarlo libremente en reuniones o mientras trabajo; mi productividad subió muchísimo. Por si a alguien le da curiosidad, comparto el artículo que uso
Una de las cosas que extraño de cuando trabajaba en oficina era estar frente a un pizarrón grande diseñando con colegas. Cuando tú y otra persona toman marcadores y se ponen a pensar la arquitectura, a veces salen diseños de clases realmente elegantes
Yo uso excalidraw para eso y creo que es mejor que un pizarrón. 1) se ve mejor y no queda desordenado, 2) los marcadores digitales no se secan, 3) es fácil editar y cambiar cosas. Siempre empiezo con excalidraw cuando hago diseño técnico
Yo uso una pantalla con lápiz de 24 pulgadas. Cuando era CTO, se la daba a todo mi equipo. Un pizarrón digital compartido que se puede seguir editando sin tener que redibujar todo varias veces es comodísimo. Tampoco hace falta sacar fotos antes de borrar el pizarrón
El pizarrón (incluyendo el de tiza) es vida