- En el desarrollo de software, programar está cerca de ser la última etapa de decirle a la computadora qué hacer, y antes lo necesario es decidir qué construir y cómo hacerlo
- Al abrir el editor de código, es fácil entrar de inmediato en modo de ejecución, concentrándose en implementar, por lo que hace falta tiempo lejos de la computadora para pensar con creatividad
- Al escribir y hacer bocetos en una libreta, las ideas vagas se vuelven concretas en texto e imágenes, y se vuelve más difícil pasar por alto vacíos de comprensión
- En la libreta se organizan la solución inicial a un problema nuevo, bocetos de UI, diagramas de flujo, y el flujo de datos e interacciones de una base de código existente para definir la dirección de la implementación
- Si se ordenan las ideas por escrito como si se estuviera explicando el código, resulta más fácil encontrar inconsistencias de diseño, mala estructura y errores, y además queda un registro del proceso de pensamiento para volver a consultarlo después
Pensar mejor sobre desarrollo fuera de la computadora
- En el desarrollo de software, escribir código es necesario, pero antes hay que decidir lo esencial: qué código escribir y cómo abordarlo
- Cuando el editor de código está abierto, uno entra de inmediato en un estado de escribir algo que funcione, y en ese estado el pensamiento creativo no fluye tan bien
- Al resolver problemas, la persona se aleja de la computadora para salir a caminar o se sienta con una libreta en el sofá o en un patio al aire libre a pensar
- Se mencionan lugares para caminar junto al agua como San Francisco Bay, Spree y Aurajoki
- En la libreta se imagina la solución inicial para un problema nuevo y se diseña el enfoque, además de hacer bocetos de UI o diagramas de flujo
- Incluso al trabajar con una base de código existente, se organizan en la libreta el flujo de datos y las interacciones, y a partir de eso se encuentra cómo corregir errores o agregar nuevas funcionalidades
El efecto que dejan la escritura y los bocetos
- Escribir y hacer bocetos son herramientas de pensamiento que convierten ideas vagas y abstractas en palabras e imágenes
- Cuando uno piensa solo en la cabeza, es fácil saltarse huecos de conocimiento o comprensión, pero al escribirlos resulta difícil evitarlos
- Después de escribir código, se prefiere organizarlo por escrito como si se lo estuviera explicando a otra persona
- Si es posible, se publica como entrada de blog
- Incluso cuando no se puede publicar, escribir de la misma forma ayuda a encontrar inconsistencias en el código, mal diseño y errores
- Deja como texto relacionado how writing is my favourite refactoring tool
- Pensar por escrito hace que el propio proceso mental quede registrado, así que disminuye la necesidad de crear notas separadas
- Luego solo hace falta reorganizarlo y pulirlo para que sea útil más adelante
- Si alguien pregunta dentro de 2 semanas, 6 meses o 2 años por qué se tomó cierta decisión, se puede volver a la libreta y revisar lo que se pensaba en ese momento
- Muchas veces quien hace esa pregunta es uno mismo en el futuro
- También hay otro texto centrado más en el contenido de las notas de trabajo: how I take work notes as a developer
1 comentarios
Opiniones de Hacker News
Buena discusión. Creo que el punto no es cuaderno vs. herramientas digitales, sino qué hace que cambien los engranajes en la cabeza.
Cada vez que cambias de modo, el cerebro presta atención de otra manera, y ese nuevo contexto puede mejorar la concentración, la creatividad e incluso la recuperación de recuerdos. Hace poco empecé a escribir todas las noches como nuevo pasatiempo, en vez de programar, y sentí que el cerebro se reiniciaba y que también mejoraba mi rendimiento durante el día. Con la planificación pasa lo mismo: al pasar de lo digital al lápiz y papel, se rompe la rutina y el cerebro se involucra de otra forma. Más que la herramienta en sí, lo importante es que el cambio despierta la mente.
No lo he visto mucho en otros lados, pero durante los últimos 9 años cambió mi forma de abordar problemas y aprendizaje. Cambiar a un cuaderno también lo uso como una buena forma de provocar eso.
Para describir un objeto tridimensional en dos dimensiones se necesitan proyecciones adicionales. Para describir en general un objeto 3D en 2D se necesitan tres dibujos. Si el objeto es más complejo que algo tridimensional, hay que verlo desde muchos más ángulos.
Con los años uso menos la grabadora de voz, pero cuando falta tiempo y tengo que pasar a lo siguiente, me parece lo óptimo. Usar una grabadora de voz como medio incluye el proceso de volver a escucharla después con atención y escribir lo dicho de otra manera. No importa si termina en un cuaderno de papel más permanente o en un archivo de texto. Cada repetición transforma en cierta medida el pensamiento, y eso da la oportunidad de ver la idea de otra forma.
Ir a la cocina, hervir agua y esperar a que infusione me obliga a alejarme del escritorio, y mientras espero tengo la oportunidad de empezar a pensar en voz alta. A veces, solo levantarme de la silla resuelve un problema difícil y la respuesta queda clara. Eso sí, incluso después de años, a veces no me acuerdo de hacerlo y sigo trabado.
Algunas de las personas más inteligentes que conocí en matemáticas, física y ciencias de la computación no usaban cuadernos, sino hojas de impresora y pluma. Al terminar, tiraban el papel.
Rara vez me resultaron útiles notas personales antiguas. Lo que vale la pena anotar lo documento, para que más adelante otra persona pueda encontrar por casualidad algo raro que yo descubrí. Lo que realmente quiero recordar lo convierto en tarjetas de memoria y lo estudio con repetición espaciada hasta aprenderlo. Dicho eso, mi método quizá no le sirva a mucha gente. Parece que están tomando este texto de una forma demasiado personal y literal. Es un texto que comparte la filosofía del autor, no una declaración de que todos deban seguirla. Si la pluma y el cuaderno no te funcionan, no los uses.
Hay cientos de artículos relacionados y es un fenómeno bien documentado: https://www.newscientist.com/article/2414241-writing-things-...
La escritura a mano tiene un efecto mayor porque usa más sentidos y áreas del cerebro que teclear, en particular la corteza motora. Sigo pensando que sería una buena excusa para comprar un Moleskine, pero la escritura a mano no forma parte de mi flujo de trabajo. En cambio, me funciona más teclear mucho contenido en un buffer de texto y luego transformarlo, especialmente ahora que también existen los LLM. Cuando el cerebro se me detiene por completo, empiezo a escribir frases casi ininteligibles en un editor de texto y, cuando la cabeza despierta, vuelvo a editar, refactorizar y ordenar. A menudo de ahí sale un esquema borroso del correo o el código que tengo que escribir ese día, o al menos algo parecido a una lista de tareas. La mayoría de los garabatos iniciales los borro. Aun así, es cierto que la escritura a mano ayuda a retener recuerdos.
Periódicamente reviso las notas y paso lo que vale la pena conservar a un sistema de registro adecuado, resumido. Puede ser calendario, tickets, wiki, repetición espaciada o lo que sea. Del mismo modo, lo que de verdad vale la pena conservar es muy poco, y eso está bien. Las notas en papel no son tanto un sistema de registro como una extensión de la memoria de trabajo.
Puede que haya valor en revisarlo, pero no he logrado obligarme a hacerlo.
A veces, cuando anoto algo que podría olvidar y que quiero consultar después, pego un post-it pequeño sobresaliendo para encontrarlo fácilmente.
Decir que el cuaderno es “la herramienta más importante” para un desarrollador es puro romanticismo. Puede ser útil para algunas personas, pero no deberíamos fingir que es más importante que un depurador, control de versiones o integración continua. Esto es ingeniería de software, no hacerse el artesano
Las herramientas que mencionas obviamente son importantes, y yo también las uso muchísimo. No querría trabajar como desarrollador sin control de versiones ni depurador. Si las perdiera, sin duda sería más lento y me frustraría. Aun así, para mí el cuaderno es más importante que eso. Escribir y ejecutar código es una herramienta para terminar el trabajo, pero para mí el desarrollo de software consiste en resolver problemas o crear algo valioso que haga la vida más fácil. Ahí, el código muchas veces es un detalle de implementación relativamente menor, y entender qué construir y cómo hacerlo es mucho más importante. Algunas personas piensan bien dentro de un editor de código o con herramientas digitales, pero cuando empiezo a crear una funcionalidad en el editor entro en modo de implementación detallada y me cuesta ver el panorama general. Por eso, usar un cuaderno antes y durante la programación como herramienta para pensar es central en mi trabajo. Si no pudiera usar otras herramientas, sería más lento; pero si no pudiera escribir con pluma y papel para pensar, mi capacidad de razonamiento, resolución de problemas y creatividad se verían muy dañadas, y al final terminaría escribiendo mal software
También están los casos en que describen un flujo de trabajo ideal en Obsidian pero no dejan notas útiles, o dicen que su forma de bloguear es tan particular que tuvieron que crear su propio motor de blog, y terminan dedicando tiempo a construir el blog en vez de escribir. A mí también me pasó. Me gusta la frase “esto es ingeniería de software, no hacerse el artesano”. Me la voy a robar y la voy a anotar en mis notas
La diferencia entre un maquinista de cuello azul y un ingeniero de cuello blanco está en cómo ven las máquinas que usan. Para un ingeniero, una máquina —ya sea una regla de cálculo, una calculadora o una supercomputadora— es simplemente una herramienta. No haces ingeniería porque uses esa herramienta; haces ingeniería porque piensas y la herramienta ayuda a que ese pensamiento avance un poco más rápido. Para un maquinista, la máquina es el trabajo. Si no hay una máquina para hacer el objeto, no puede hacer el objeto; y como pensar por sí solo no fabrica objetos, pensar en el objeto se vuelve inútil
Pero el núcleo emocional sigue siendo correcto. Al crear software, el buen diseño de código es la parte más fundamentalmente importante del trabajo. Las herramientas que mencionas permiten entregar ese código, pero si el diseño del código en sí está mal, no significan mucho. Hoy en día, el proceso de diseñar código se siente como una habilidad perdida. Los desarrolladores están demasiado acostumbrados a lanzar cualquier cosa contra la pared con tal de que pase los criterios de aceptación. En buena parte de la comunidad de desarrollo falta el proceso de analizar la lógica y el flujo del código en papel, en una app de diagramas o algo similar. Si más gente estuviera dispuesta a revisar la lógica de una funcionalidad antes de abrir el IDE y depurar el primer código que se les ocurra, quizá las apps tendrían un poco menos de bugs
La mayoría de los comentarios se enfoca en la pluma y el papel físicos, pero se está perdiendo el principio de fondo
El autor usa pluma y papel porque, al sentarse frente a la computadora, cambia a un modo funcional en el que implementa en vez de diseñar. Eso es todo. El takeaway importante es no caer en la trampa de meterse a implementar cuando lo que hace falta es diseñar. Cómo mantener ese equilibrio depende de cada quien
Lo importante es encontrar las herramientas que te funcionan. Una de las razones por las que quería escribir esto era que, en equipos técnicos donde todos están sentados frente a la computadora 7.5 horas al día, muchas veces me sentía como un outsider por ser alguien que piensa mejor lejos de la pantalla y el teclado. Quería mostrar un ejemplo para gente como yo, y para quienes sienten que no encajan
Llevo unos 20 años usando software, y antes de eso hice un doctorado en química orgánica e investigué durante algunos años. Trabajo como senior en Australia y me pagan bastante bien
Tengo afantasía (aphantasia), así que no puedo visualizar objetos ni imaginarlos como imágenes en mi cabeza. Por eso uso muchísimo pluma y papel, y pizarrones. Hago ERD, mapas mentales, diagramas de secuencia, etc., y uso ReMarkable para que moverme y organizarme sea un poco más fácil y efectivo. Algunas personas podrían ver esto como puro romanticismo, pero la pluma y el papel fueron decisivos para mi éxito
Como la entrevista tiene límite de tiempo, empiezo a programar de inmediato para producir algo que mostrar; pero como no puedo dibujar nada en mi cabeza, literalmente estaba programando a ciegas. Me quedaba releyendo el problema una y otra vez, esperando que se me ocurriera una solución. Después de darme cuenta, empecé a dibujar el problema en un cuaderno A2, resolverlo sobre el papel y finalmente mapear la solución también en papel. Entonces, como por magia, el código sale de forma natural. Supongo que así es como piensa la gente común cuando programa
He probado ambas cosas. Probé lo completamente digital y también lo totalmente centrado en cuadernos. Lo mejor que he encontrado hasta ahora es dejar las notas de largo plazo en una app de notas y mantener en el cuaderno el proceso de pensamiento en curso
Cosas como en qué estoy trabajando ahora o el proceso que estoy siguiendo. Así se reducen los problemas de búsqueda y copiado de las notas físicas. Pero cuando escribo a mano un proceso o una tarea en curso, lo recuerdo mucho mejor. A veces basta con escribirlo y no necesito volver a verlo. Aun así, cuando sí necesito revisarlo, entiendo mejor cómo llegué al resultado final, porque el recorrido está en el cuaderno. También ayuda que me gusten las plumas fuente
Tienes que elegir un bando y comprometerte por completo, como todos en esta sección de comentarios. Pero como ya probaste ambos lados con mente abierta, es decir, lo completamente digital y lo completamente de cuaderno, ya es demasiado tarde. Por lo tanto, tu criterio queda automáticamente invalidado y está equivocado. Así son las reglas
No entiendo lo de usar pluma y libreta física. Escribir es lento, buscar lo que escribiste es absurdamente lento, y copiar o compartir es casi imposible.
Esa libreta es la herramienta más rápida y accesible para capturar mis pensamientos. Antes de que cualquier app de notas termine de arrancar, puedo decir de forma concisa qué discutimos en la reunión de equipo de octubre pasado. Sé los nombres de los hijos de casi todos mis colegas, sus cumpleaños y sus películas favoritas, y puedo revisarlo durante una pantalla compartida sin cambiar de ventana. Que ese contenido sea difícil de leer para otros e imposible de compartir es una característica que valoro muchísimo. La llevo a donde quiero para reflexionar y tomar notas. No tiene pantalla ni distracciones. Garabateo, trazo líneas, escribo chistes, lo que sea. La página derecha es para el trabajo; la izquierda, para mis ideas. El índice de la primera página me dice exactamente dónde están las ideas para llenar formularios aburridos y los mockups. También puedo darme cuenta cuando estoy dando vueltas sin avanzar. Puedo ver huecos en mi pensamiento de hace meses, o patrones de comportamiento humano que de otro modo se me habrían escapado. Su simplicidad es una ventaja enorme, así que dejé de buscar algo mejor. Salvo casos especiales, ni siquiera intento promoverla. Me ha ahorrado muchísimo tiempo.
https://www.scientificamerican.com/article/why-writing-by-ha...
https://stackoverflow.blog/2022/11/23/why-writing-by-hand-is...
Para un cerebro distraído como el mío, escribir a mano definitivamente funciona mejor. La capacidad de búsqueda está sobrevalorada. La mayoría de las notas son de solo escritura y tienden a acumularse sin volver a leerse. Así que, en lugar de optimizar para que sean fáciles de buscar en la computadora, conviene optimizar para la retención de memoria, de modo que más adelante puedas formar mejores conexiones mentales con el material. Las notas en la PC son pasivas. Lo que quieres es integrar ese contenido en tu cerebro para poder hacer algo real con él.
Estoy totalmente de acuerdo con el autor. Frente a la computadora es muy difícil pensar en profundidad y hay demasiadas distracciones. Para mí, la velocidad de escritura y la búsqueda no son un problema. Sí me gustaría escribir más rápido, pero pensar profundamente no es algo rápido en sí. Lo mismo con la búsqueda: el 99% de lo que escribo nunca lo vuelvo a consultar. Todo forma parte del proceso de resolver problemas y grabarlos en la memoria. Cuando me atoro, alejarme de la computadora suele ser el mejor siguiente paso.
Anota todo lo que el profesor escriba en el pizarrón. Te sorprenderá cuánto recuerdas de la clase. Y al leer tus notas manuscritas, también vuelve a tu mente la clase de ese momento.
Como almacén de información a largo plazo, son una herramienta completamente equivocada. Solo sirven para notas temporales del proceso de pensamiento. Cualquier cosa que deba vivir más que el problema que estoy resolviendo en ese momento la pongo en Obsidian.
Durante años intenté organizarme probando todo tipo de herramientas y apps de notas, hasta que como parte de mis propósitos de Año Nuevo de este año compré un paquete de blocks de lista de tareas con espacio para la fecha, y decidí escribir ahí de forma libre durante reuniones o mientras trabajo. Me sorprendió cuánto mejoró mi productividad después de hacerlo.
Producto, para quien tenga curiosidad: https://www.amazon.com/dp/B0BS1WJZNW
Prefiero muchísimo escribir a mano.[1] He usado bastante Moleskine y Field Notes, también Muji durante mucho tiempo, y ahora estoy muy impresionado con Midori.
Ya compré varias y planeo comprar muchas más. La sensación táctil de “raspado” que produce una pluma fuente sobre el papel Midori es tan calmante que, aunque esté anotando la idea más común y corriente, me hace sentir como poeta :-)
https://brajeshwar.com/2025/notes/
Una de las pocas cosas que extraño del trabajo en oficina es tener un pizarrón blanco grande y estar frente a él con un colega.
Cuando abordábamos la arquitectura con marcadores en mano, solíamos terminar con diseños de clases realmente elegantes.
La última vez que trabajé como CTO, le compré una a todo el equipo. Si puedes redibujar en un pizarrón digital compartido, ya no tienes que volver a dibujar doce veces los mismos cuatro rectángulos porque te quedaste sin espacio. También reduces la necesidad de tomarle foto al pizarrón antes de borrarlo.