6 pontos por GN⁺ 2025-05-29 | 1 comentários | Compartilhar no WhatsApp
  • No desenvolvimento de software, programar está mais para a etapa final de dizer ao computador o que fazer; antes disso, o necessário é decidir o que construir e como construir
  • Ao abrir o editor de código, é fácil entrar imediatamente no modo de execução, mergulhando na implementação, por isso é preciso passar um tempo longe do computador para pensar de forma criativa
  • Ao escrever e fazer esboços no caderno, ideias vagas ganham forma concreta em texto e desenhos, e fica mais difícil pular lacunas de entendimento
  • O autor organiza no caderno a solução inicial para novos problemas, esboços de UI, fluxogramas e o fluxo de dados e as interações da base de código existente para definir a direção da implementação
  • Quando organiza as ideias por escrito como se estivesse explicando o código, fica mais fácil encontrar incompatibilidades de projeto, estruturas ruins e erros, além de deixar um registro do processo de pensamento para consultar depois

Pensar melhor sobre desenvolvimento fora do computador

  • No desenvolvimento de software, escrever código é necessário, mas antes disso o essencial é decidir que código escrever e como abordar o problema
  • Quando o editor de código está aberto, a pessoa entra logo no estado de escrever algo que funcione, e nesse estado o pensamento criativo não flui tão bem
  • Ao resolver problemas, o autor se afasta do computador para caminhar ou se senta com um caderno no sofá ou em um pátio externo para pensar
    • São mencionados lugares para caminhar perto da água, como San Francisco Bay, Spree e Aurajoki
  • No caderno, ele idealiza a solução inicial para novos problemas, desenha a abordagem e faz esboços de UI ou fluxogramas
  • Mesmo ao lidar com uma base de código existente, ele organiza no caderno o fluxo de dados e as interações, e com isso encontra formas de corrigir bugs ou adicionar novos recursos

O efeito que escrever e desenhar deixa

  • Escrever e fazer esboços são ferramentas de pensamento que transformam ideias vagas e abstratas em palavras e imagens
  • Lacunas de conhecimento ou de entendimento que podem passar despercebidas quando se pensa só na cabeça ficam muito mais difíceis de evitar quando são colocadas no papel
  • Depois de escrever o código, o autor prefere organizar as ideias por escrito como se estivesse explicando para outra pessoa
    • Sempre que possível, publica isso em forma de post de blog
    • Mesmo quando não pode publicar, escrever desse jeito ajuda a encontrar inconsistências no código, mau design e erros
    • Ele também escreveu sobre isso em how writing is my favourite refactoring tool
  • Pensar por escrito faz com que o próprio processo de pensamento fique registrado, reduzindo a necessidade de criar notas separadas
    • Depois basta reorganizar e lapidar o texto para que fique útil no futuro
  • Se alguém perguntar, 2 semanas, 6 meses ou 2 anos depois, por que uma determinada decisão foi tomada, ele pode voltar ao caderno e confirmar o que pensava na época
    • Muitas vezes, quem faz essa pergunta é o próprio eu do futuro
  • Há também um texto separado mais focado no conteúdo das anotações de trabalho: how I take work notes as a developer

1 comentários

 
GN⁺ 2025-05-29
Comentários do Hacker News
  • Boa discussão. Acho que o ponto central não é caderno versus ferramentas digitais, mas o que faz as engrenagens na sua cabeça mudarem de marcha
    Cada vez que você muda de modo, o cérebro passa a prestar atenção de outra maneira, e esse novo contexto pode aumentar a concentração, a criatividade e até a evocação da memória. Recentemente comecei a escrever todas as noites como novo hobby, em vez de programar, e isso reseta meu cérebro e melhora meu desempenho no trabalho durante o dia. Com planejamento é a mesma coisa: trocar o digital por caneta e papel quebra a rotina e faz o cérebro se envolver de outro jeito. Mais do que a ferramenta em si, o mais importante é que a mudança desperta a mente

    • Conheci pela primeira vez o conceito de disfluência (disfluency) em Smarter Faster Better. É a ideia de que um atrito adicional — uma fonte estranha, um ambiente novo, uma ferramenta diferente — tira você do modo piloto automático e faz pensar de uma nova maneira
      Não vi isso em muitos outros lugares, mas nos últimos 9 anos mudou minha forma de abordar problemas e aprendizado. Passar para um caderno também é uma das boas formas que uso para provocar isso
    • Fico curioso para saber quantos desenvolvedores hoje foram obrigados a fazer uma aula introdutória de desenho técnico. Imagino que muita gente tenha brincado com Lego
      Para explicar um objeto tridimensional em duas dimensões, é preciso uma projeção adicional. Para descrever razoavelmente um objeto tridimensional em 2D, são necessários três desenhos. Se o objeto for mais complexo que 3D, é preciso observá-lo por muito mais ângulos
    • Por isso, na prática faço anotações em três mídias: caderno de papel, gravador de voz digital à moda antiga e arquivos de texto. Cada mídia tem prós e contras diferentes, e há pensamentos que são melhor expressos em cada uma
      Com o passar dos anos uso menos o gravador de voz, mas acho que ele é ideal quando falta tempo e preciso passar para a próxima coisa. Usar um gravador de voz como mídia inclui o processo de, depois, ouvir de novo com atenção e registrar o que foi dito de outra forma. Não importa se é em um caderno de papel mais permanente ou em um arquivo de texto. A cada repetição, o pensamento se transforma em alguma medida, e isso dá a chance de enxergar a ideia de outro jeito
    • Então, além do fato de eu ser irlandês, bebo bastante chá ao longo do dia
      Ir até a cozinha, ferver água e esperar a infusão me tira da mesa, e enquanto espero tenho a oportunidade de começar a pensar em voz alta comigo mesmo. Às vezes, só levantar da cadeira já resolve um problema difícil e deixa a resposta clara. Mesmo assim, depois de anos, às vezes ainda não lembro disso e continuo insistindo no problema
    • Um estudo que li tempos atrás dizia que o custo de troca de contexto é de cerca de 15 minutos em média. Não sei o quanto isso é preciso, mas meus chefes sempre acreditaram nisso e tentaram respeitar
  • Algumas das pessoas mais inteligentes que conheci em matemática, física e ciência da computação nem usavam caderno: usavam papel de impressora e caneta. Quando terminavam, jogavam o papel fora
    Foram raras as vezes em que anotações pessoais antigas foram úteis. O que vale a pena registrar, eu documento, para que no futuro outra pessoa possa eventualmente encontrar alguma coisa estranha que descobri. O que realmente quero lembrar, transformo em flashcards e estudo com repetição espaçada até aprender. Ainda assim, meu método pode não servir para muita gente. Parece que as pessoas estão levando este texto de forma pessoal demais e literal demais. É um texto compartilhando a filosofia do autor, não uma declaração de que todo mundo deve segui-la. Se caneta e caderno não funcionam para você, é só não usar

    • Do ponto de vista científico, o ato de escrever aumenta a memória, retenção e aprendizado, mesmo que você descarte logo em seguida o que escreveu
      Há centenas de artigos relacionados, e é um fenômeno bem documentado: https://www.newscientist.com/article/2414241-writing-things-...
      A escrita à mão é mais eficaz porque usa mais sentidos e áreas do cérebro do que a digitação, especialmente o córtex motor. Vivo pensando que isso seria uma boa desculpa para comprar um Moleskine, mas a escrita à mão não faz parte do meu fluxo de trabalho. Em vez disso, para mim funciona melhor digitar muita coisa em um buffer de texto e depois transformá-la, especialmente agora que também existem LLMs. Quando meu cérebro trava completamente, começo a digitar frases quase irreconhecíveis em um editor de texto e, quando a cabeça desperta, volto para editar, refatorar e organizar. Com frequência isso acaba virando o e-mail ou o código que preciso escrever naquele dia, um esboço nebuloso, ou pelo menos algo parecido com uma lista de tarefas. A maior parte dos rabiscos iniciais eu apago. Ainda assim, é verdade que escrever à mão ajuda na retenção da memória
    • Para mim, é importante que o método de coleta de notas seja não estruturado e totalmente livre. Boa parte do que preciso registrar é não linear, não verbal, relacional, espacial ou composta por fatos que precisam ficar na memória temporária, então anotações digitadas no teclado não funcionam bem
      Periodicamente reviso as notas e resumo o que vale guardar, transferindo para um sistema de registro adequado. Pode ser calendário, tickets, wiki, repetição espaçada, tanto faz. Da mesma forma, muito pouco realmente merece ser preservado, e tudo bem. Anotações em papel são menos um sistema de registro e mais uma extensão da memória de trabalho
    • São raras as vezes em que anotações pessoais antigas são úteis, mas ainda assim guardo todos os cadernos e pedaços de papel. É extremamente satisfatório olhar para eles anos depois. É como ver fotos antigas aleatórias, só que de processos de pensamento do passado
    • Meu cérebro também funciona assim. Tenho cadernos, mas escrevo o fluxo de pensamentos do dia em uma página naquele mesmo dia e, quando viro a página no dia seguinte, quase nunca volto a olhar
      Pode haver valor em revisitar, mas nunca consegui me fazer fazer isso
    • A maior parte do conteúdo dos meus cadernos eu nunca releio. São listas de pensamentos, sequências de acontecimentos e coisas assim
      Às vezes, quando anoto algo que posso esquecer e quero consultar depois, colo um post-it pequeno sobressaindo para conseguir encontrar facilmente
  • Para um desenvolvedor, dizer que o caderno é a “ferramenta mais importante” é romantismo puro. Pode ser útil para algumas pessoas, mas não devemos fingir que é mais importante do que um depurador, controle de versão ou integração contínua. Isso não é imitar artesão; é engenharia de software

    • Sou o autor do texto original. Da última vez que meu blog chamou atenção no HN, disseram que eu “vivia em uma fantasia”; agora ouço que é “romantismo puro”
      As ferramentas que você mencionou obviamente são importantes, e eu também as uso muito bem. Eu não gostaria de trabalhar como desenvolvedor sem controle de versão ou depurador. Se eu as perdesse, com certeza ficaria mais lento e irritado. Mesmo assim, para mim, o caderno é mais importante do que elas. Escrever e executar código é uma ferramenta para concluir o trabalho, mas, para mim, desenvolvimento de software é criar algo de valor que resolva problemas ou torne a vida mais fácil. Nesse contexto, o código muitas vezes é um detalhe de implementação relativamente pequeno, e entender o que construir e como construir é muito mais importante. Algumas pessoas pensam bem dentro do editor de código ou de ferramentas digitais, mas, quando começo a criar uma funcionalidade no editor, entro no modo de implementação detalhada e fica difícil enxergar o panorama geral. Por isso, antes e durante a codificação, usar o caderno como uma ferramenta de pensamento é uma parte central do meu trabalho. Se eu não puder usar outras ferramentas, ficarei mais lento; mas, se eu não puder pensar escrevendo com caneta e papel, minha capacidade de raciocínio, resolução de problemas e criatividade serão muito prejudicadas, e no fim acabarei escrevendo software ruim
    • Há muita coisa parecida em textos sobre sistemas de produtividade. As pessoas passam um tempo infinito enfeitando anotações de GTD cheias de abas e listas, mas não fazem trabalho realmente produtivo
      Também há casos em que alguém descreve um fluxo de trabalho ideal no Obsidian, mas não deixa anotações realmente úteis; ou passa o tempo criando um blog, em vez de escrever, dizendo que seu jeito de blogar é tão único que precisou criar o próprio motor de blog. Eu também já passei por isso. Gosto da frase “isso não é imitar artesão; é engenharia de software”. Vou roubar e anotar no meu caderno
    • Isso não é engenharia de software; está mais perto de usinagem de software
      A diferença entre um maquinista operário e um engenheiro de colarinho branco está na forma como enxergam as máquinas que usam. Para um engenheiro, a máquina, seja uma régua de cálculo, uma calculadora ou um supercomputador, é apenas uma ferramenta. Ele não faz engenharia porque usa essa ferramenta; faz engenharia porque pensa, e a ferramenta ajuda esse pensamento a andar um pouco mais rápido. Para o maquinista, a máquina é o próprio trabalho. Sem a máquina para fabricar o objeto, não é possível fabricá-lo; e, como o objeto não surge apenas pelo pensamento, pensar sobre ele se torna sem sentido
    • A objeção literal é válida. Usar caderno é antiquado, e há ferramentas melhores
      Mas o núcleo do sentimento continua correto. Ao criar software, o bom design de código é a parte mais fundamentalmente importante do trabalho. As ferramentas mencionadas permitem entregar esse código, mas, se o design do código em si estiver errado, elas não têm grande significado. Hoje, o processo de design de código parece uma habilidade perdida. Desenvolvedores estão acostumados demais a jogar qualquer coisa na parede só o suficiente para passar nos critérios de aceitação. Em boa parte da comunidade de desenvolvimento, falta de fato o processo de examinar a lógica e o fluxo do código no papel, em aplicativos de diagramação etc. Se as pessoas se dispusessem a revisar a lógica de uma funcionalidade antes de abrir a IDE e depurar o primeiro código que viesse à cabeça, talvez os apps tivessem um pouco menos de bugs
    • Parece dizer algo como: “Ao construir uma casa, é claro que o martelo é mais importante do que a planta. Isso é construção, não aula de artes”
  • A maioria dos comentários se concentra na caneta e no papel físicos, mas perde o princípio por baixo
    O autor usa caneta e papel porque, quando senta diante do computador, muda para o modo funcionalidade, no qual implementa em vez de projetar. É só isso. O takeaway importante é não cair na armadilha de mergulhar na implementação quando você deveria estar projetando. Como manter esse equilíbrio depende de cada um

    • Sou o autor do texto original. Exatamente. Fico muito feliz que você tenha captado o ponto central da história
      O importante é encontrar as ferramentas que funcionam para você. Um dos motivos pelos quais eu quis escrever este texto foi que, em uma equipe técnica em que todo mundo passa 7,5 horas por dia sentado na frente do computador, muitas vezes eu me sentia como um outsider por ser alguém que pensa melhor longe da tela e do teclado. Eu queria mostrar um exemplo para pessoas como eu e para quem sente que não se encaixa
  • Uso software há cerca de 20 anos e, antes disso, fiz doutorado e pesquisa em química orgânica por alguns anos. Trabalho como sênior na Austrália e sou bem remunerado
    Tenho afantasia (aphantasia), então não consigo visualizar objetos nem imaginá-los como imagens na cabeça. Por isso uso muito caneta e papel, além de quadro branco. Crio ERDs, mapas mentais, diagramas de sequência etc., e uso um ReMarkable para tornar o deslocamento e a organização um pouco mais fáceis e eficazes. Algumas pessoas podem ver isso como romantismo puro, mas caneta e papel foram decisivos para o meu sucesso

    • A maioria dos humanos não consegue visualizar muitas coisas ao mesmo tempo na cabeça. Acho que o limite médio é baixo. Por isso todos nós nos beneficiamos de caneta e papel, mas também reconheço que algumas pessoas se beneficiam mais
    • Estou na mesma situação. Tenho 20 anos de experiência na Austrália e tenho afantasia. Só no último mês percebi por que eu não consigo fazer entrevistas com live coding
      Como a entrevista tem limite de tempo, eu começava a codificar imediatamente para produzir algo para mostrar, mas, como não consigo desenhar nada na cabeça, estava literalmente codificando às cegas. Eu ficava relendo o problema, esperando que uma solução surgisse. Depois que percebi isso, comecei a desenhar o problema em um caderno A2, resolver no papel e, por fim, mapear a solução no papel. Então, como mágica, o código sai naturalmente. Imagino que seja assim que as pessoas comuns pensam ao programar
  • Já fiz os dois. Tentei tanto o totalmente digital quanto o totalmente centrado em caderno. O melhor que encontrei até agora é deixar anotações de longo prazo em um app de notas e manter o processo de pensamento em andamento no caderno
    Coisas como o que estou fazendo agora e o processo para chegar lá. Isso reduz os problemas de busca e cópia das anotações físicas. Mas, quando escrevo à mão o processo ou a tarefa em andamento, lembro muito melhor. Às vezes, só escrever já basta, e nem preciso consultar depois. Ainda assim, quando preciso consultar, tenho uma noção melhor de como cheguei ao resultado final, porque a jornada está registrada no caderno. Gostar de canetas-tinteiro também ajuda

    • Desculpe, mas isso não é permitido
      Você precisa escolher um lado e se comprometer totalmente, como todo mundo nesta seção de comentários. Mas, como você já tentou os dois lados com a mente aberta, ou seja, o totalmente digital e o totalmente em caderno, é tarde demais. Portanto, seu julgamento é automaticamente inválido e está errado. Essas são as regras
  • Não entendo caneta e caderno físico. A velocidade de escrita é lenta, buscar o que foi escrito é absurdamente lento, e copiar ou compartilhar é quase impossível

    • Interessante. Uma vez falei com entusiasmo a um colega sobre as vantagens do caderno espiral que está sempre na minha mesa, e esse colega, que tentava me ajudar numa situação difícil, ficou em silêncio. Aquele caderno era a diferença entre mim e ele, mas ele não entendeu
      Esse caderno é a ferramenta mais rápida e acessível que tenho para capturar meus pensamentos. Antes mesmo de qualquer app de notas terminar de abrir, consigo dizer de forma concisa o que discutimos na reunião de equipe de outubro passado. Sei o nome, o aniversário e o filme favorito dos filhos de quase todos os colegas, e consigo dar uma olhada nisso durante um compartilhamento de tela sem alternar janelas. O fato de esse conteúdo ser difícil para outras pessoas lerem e impossível de compartilhar é uma funcionalidade que valorizo muito. Levo para onde quiser, reflito e faço anotações. Não há tela nem distrações. Rabisco, traço linhas, escrevo piadas, faço qualquer coisa. A página da direita é para trabalho; a da esquerda, para minhas ideias. O índice da primeira página me diz exatamente onde estão ideias e mockups para preencher formulários chatos. Também consigo perceber quando estou patinando. Consigo ver lacunas no meu pensamento de alguns meses atrás, ou padrões de comportamento humano que eu teria deixado passar. A simplicidade é uma vantagem tão enorme que parei de procurar algo melhor. Exceto em casos especiais, nem tento promover isso. Economizou muito do meu tempo
    • Fazendo uma busca rápida:
      https://www.scientificamerican.com/article/why-writing-by-ha...
      https://stackoverflow.blog/2022/11/23/why-writing-by-hand-is...
      Para um cérebro distraído como o meu, escrever à mão é claramente melhor. A capacidade de busca é superestimada. A maioria das anotações é só para escrita e tende a se acumular sem nunca ser relida. Então, em vez de otimizar para que seja fácil buscar no computador, é melhor otimizar para retenção de memória, de modo a criar depois uma conexão mental melhor com o material. Notas no PC são passivas. O que se quer é integrar esse conteúdo ao cérebro para realmente conseguir fazer algo com ele
    • Cada pessoa tem um jeito que funciona para si
      Concordo totalmente com o autor. Na frente do computador é muito difícil pensar profundamente, e há distrações demais. Velocidade de escrita e busca não são problemas para mim. Eu até gostaria de escrever mais rápido, mas pensar profundamente em si não é algo rápido. O mesmo vale para busca: 99% do que escrevo eu nunca revejo. Tudo faz parte do processo de resolver problemas e gravar na memória. Quando fico travado, afastar-me do computador costuma ser o melhor próximo passo
    • Se você quiser aproveitar ao máximo uma aula de física, deixe o notebook em casa e leve um caderno espiral e canetas coloridas
      Anote tudo que o professor escreve no quadro. É surpreendente o quanto você vai lembrar do conteúdo da aula. E, ao ler as anotações manuscritas, a própria aula daquela época também volta à mente
    • Eu também continuo usando caderno e caneta como engenheiro de software, mas nunca os uso quando preciso das propriedades mencionadas agora
      Como repositório de informações de longo prazo, é uma ferramenta completamente errada. Serve apenas para anotações temporárias do processo de pensamento. Qualquer conteúdo que precise sobreviver ao problema que estou resolvendo no momento fica no Obsidian
  • Durante vários anos tentei me organizar usando todo tipo de ferramenta e app de notas, até que, como parte das metas de Ano Novo deste ano, comprei um pacote de blocos de notas de lista de tarefas com campo de data e decidi escrever neles de forma aleatória durante reuniões ou enquanto trabalhava. Fiquei surpreso com o quanto minha produtividade melhorou depois disso
    O produto, para quem tiver curiosidade: https://www.amazon.com/dp/B0BS1WJZNW

  • Prefiro muito mais escrever à mão.[1] Usei bastante Moleskine e Field Notes, e também usei Muji por muito tempo, mas agora estou muito impressionado com a Midori
    Já comprei alguns cadernos e pretendo comprar muitos mais. O “arranhar” tátil que uma caneta-tinteiro faz sobre o papel Midori é tão calmante que, mesmo quando estou anotando a ideia mais banal, sinto como se eu tivesse virado poeta :-)
    https://brajeshwar.com/2025/notes/

    • O site é realmente incrível. Fiquei completamente envolvido pela história de fundo. A última vez que me diverti tanto assim foi com https://meyerweb.com/
  • Uma das poucas coisas de que sinto falta no trabalho presencial é um quadro branco grande e ficar em pé diante dele com um colega
    Quando eu trabalhava em arquitetura com um colega, cada um com um marcador na mão, costumávamos chegar a designs de classes realmente elegantes

    • Tenho uma pen display de 24 polegadas
      Na última vez em que trabalhei como CTO, comprei uma para toda a equipe. Quando dá para redesenhar em um quadro branco digital compartilhado, não é preciso redesenhar os mesmos quatro retângulos doze vezes porque faltou espaço. Também diminui a necessidade de tirar foto do quadro antes de apagar
    • Quadro branco, quadro-negro e coisas assim são a própria vida
    • Uso excalidraw para esse fim e acho melhor do que um quadro branco
      1. É mais bonito e menos bagunçado 2) marcadores digitais nunca secam 3) incentiva mais correções e mudanças. Hoje, quase todo design técnico começa no excalidraw