2 pontos por GN⁺ 2025-02-25 | 1 comentários | Compartilhar no WhatsApp
  • Ao publicar o que você aprendeu na forma de resumo ou tutorial, o efeito é criar você mesmo o texto de que precisava quando estava aprendendo no início
  • Se, em vez de parar em aprender uma nova tecnologia e experimentá-la diretamente, você a explica por escrito, o conhecimento se fixa com mais profundidade e as lacunas de compreensão também aparecem
  • O caso do post sobre a chamada de sistema epoll e a diferença entre eventos edge-triggered/level-triggered continua fácil de lembrar mesmo quase 12 anos depois de ter sido escrito
  • Segundo o Google Search Console, uma parcela considerável dos visitantes ocasionais chega por buscas relacionadas a textos de organização de aprendizado, e os termos pesquisados combinam bem com o conteúdo dos posts
  • A intenção é publicar com mais frequência registros de aprendizado em formato longo sob a categoria provisória TIL deep dives, em um formato diferente dos posts curtos de Today I learned

Escrever o texto que você gostaria de ter encontrado quando estava aprendendo pela primeira vez

  • Recentemente, ao escrever no blog mais do que de costume e reler o arquivo, o autor refletiu sobre os pontos em comum dos posts mais satisfatórios
  • Bons posts tendem a ser textos que resumem o que foi obtido no processo de aprender algo ou entender como algo funciona e, às vezes, são estruturados como tutoriais
  • Esse tipo de texto é uma forma de escrever você mesmo “o texto que eu gostaria de ter encontrado quando estava aprendendo pela primeira vez”

Organizar em texto fortalece a compreensão

  • Aprender algo novo e, se possível, colocá-lo em prática diretamente é importante para crescer como engenheiro
  • Escrever sobre o que foi aprendido faz o conhecimento se fixar com mais profundidade
  • O critério para dizer que você realmente entendeu algo está em conseguir explicá-lo a um leitor inteligente e interessado
  • O post sobre a chamada de sistema epoll e a diferença entre eventos edge-triggered/level-triggered foi escrito há quase 12 anos, mas ainda permanece na memória

Registros de aprendizado que também chegam a outras pessoas

  • Ao olhar o Google Search Console, muitos dos visitantes que não são leitores regulares chegam por buscas relacionadas a esses textos de organização de aprendizado
  • Como os termos pesquisados combinam bem com o conteúdo dos respectivos posts, é possível que os visitantes estejam encontrando o que procuravam
  • Textos públicos de aprendizado consolidam a compreensão pessoal e, ao mesmo tempo, podem chegar, por meio de buscas, a pessoas que enfrentam problemas parecidos

A categoria TIL deep dives

  • Daqui em diante, o autor pretende aumentar mais conscientemente esse tipo de post
  • Como a expressão “o tutorial que eu gostaria que alguém tivesse escrito antes de eu aprender” é longa demais, o nome provisório será TIL deep dives
  • Esses posts são diferentes dos posts curtos de “Today I learned” vistos em outros blogs
  • Eles pertencem à mesma família dos TILs de Simon Willison, mas se aproximam mais de textos em formato mais longo

1 comentários

 
GN⁺ 2025-02-25
Opiniões no Hacker News
  • Se você encontrou um texto desses, avisar o autor também deveria ser uma ação natural
    Basta mandar um e-mail curto ou deixar um comentário. Por trás de algumas celebridades do YouTube, há milhares de pessoas que publicam bom conteúdo sem ter a menor ideia de quem está vendo ou agradecendo

    • As pessoas recebem feedback positivo de menos
      Por isso, quando vejo um texto ou trabalho que me tocou, criei o hábito de mandar e-mail até para desconhecidos. Seguindo Derek Sivers e patio11, também deixei um “convite permanente” bem visível no meu site; quando às vezes chega um e-mail de “saudações de um estranho da internet”, meu dia ou minha semana melhora. E-mail é ótimo para conversas profundas e despretensiosas em ritmo lento
      https://www.evalapply.org/index.html#standing-invitation
    • Alguém publicou como consertar a tomada automotiva quebrada de um Honda Civic 1999, ou seja, o acendedor de cigarros
      Eu não fazia ideia de que havia uma pecinha parecida com um transistor embaixo do porta-luvas, e era um conserto de 50 centavos. Se aquela pessoa não tivesse publicado, eu nunca teria descoberto, então mandei uma mensagem de agradecimento
    • Certa vez, eu quis jogar de novo uma demo de um jogo que tinha visto num disco de demos de uma revista de informática do início dos anos 2000, então procurei o desenvolvedor e mandei um e-mail
      Descobri que o jogo nunca tinha sido lançado oficialmente, e a demo incluída junto com vários jogos e softwares era o único vestígio público. O desenvolvedor ainda tinha o instalador e, como era pequeno o bastante para anexar à resposta, me enviou. Tive uma forte sensação de que perguntar sobre um jogo que ele tinha feito havia mais de 20 anos deve ter melhorado bastante o dia dele
    • Isso já aconteceu comigo umas três ou quatro vezes, e em todas elas minha semana melhorou. Recomendo muito
  • O critério dos meus posts de TIL segue a mesma filosofia
    Se eu pesquisei primeiro e, mesmo assim, levei horas para entender algum problema, isso é um sinal muito forte de que vale a pena registrar por escrito. O post mais recente é sobre fazer proxy do tráfego de scraping do GitHub Actions por um nó de saída do Tailscale: https://til.simonwillison.net/tailscale/tailscale-github-act...

    • O próprio texto já diz isso
      Ele diz que “Simon Willison faz isso muito bem, a ponto de ter até um subdomínio próprio para seus TILs”
  • Sempre que conserto alguma coisa ou sofro com um problema, escrevo um post de blog para mim mesmo, incluindo o máximo possível das mensagens de erro exatas e dos termos de busca que pesquisei enquanto montava a solução

    • Dois dias atrás, eu estava tentando descobrir como fazer o Gamescope funcionar no NixOS do computador novo
      Enquanto pesquisava, encontrei um post relacionado no Reddit [1] e, ao ver que havia um GitHub Gist anexado ali, percebi que quem tinha publicado era eu. Eu tinha esquecido completamente que já havia feito esse trabalho
      [1] https://www.reddit.com/r/NixOS/comments/1dahr3g/steamos_base...
    • Minha resposta mais útil no Stack Overflow foi, na verdade, uma resposta que escrevi quando eu mal sabia o que estava fazendo
      Era um problema relacionado a MVC.net e, embora eu tivesse corrigido o mesmo problema da pergunta, eu não entendia o que queriam dizer as respostas marcadas como “melhor resposta” nem por que eram relevantes. Então escrevi o procedimento que usei para consertar, no estilo “clique aqui e digite isto para corresponder àquilo”. Só muito depois percebi que minha resposta, no fim das contas, dizia exatamente o que as outras respostas mandavam fazer, mas minha resposta continuou recebendo votos de muita gente que pesquisava sem ainda entender as ligações meio mágicas que o Visual Studio cria entre bindings, views e componentes
    • Eu também faço isso
      O último texto que escrevi foi sobre como descobri como trocar a bateria de um monitor de bebê
      https://www.michael1e.com/how-to-replace-the-eufy-spaceview-...
    • Eu também faço isso, mas ainda não sei como lidar quando sou passado para trás por autoridades LLM como Grok ou ChatGPT
      Eles não devolvem tráfego nem recompensa, e nem sequer citam como fonte ¯_(ツ)_/¯
    • Ao fazer uma pergunta, também é bom incluir tudo o que você pesquisou
      Assim, quando alguém responder, a próxima pessoa conseguirá encontrar
  • Talvez a parte mais importante desse método seja que, se eu mesmo escrever o texto que eu queria encontrar, há uma boa chance de ele voltar a ser útil para mim algum dia
    Muitos textos que escrevi continuaram úteis para mim anos depois da publicação. Esse efeito aumentou quando coloquei busca no site e passei a incluir também posts de microblog

    • O próprio ato de escrever ajuda a fixar na memória
      Às vezes, pesquisando, já encontrei posts antigos do meu próprio blog
    • Sempre esqueço o procedimento para instalar o app de gerenciamento da Ubiquiti no Arch toda vez que formato e reinstalo minha workstation
      Como escrevi isso no blog em 2019, até hoje consulto o texto para lembrar
  • Esse hábito virou um negócio de estilo de vida para mim. Hoje ganho a vida documentando a burocracia alemã
    Fiz uma apresentação sobre “por que fazer isso”, que virou um post longo no blog: https://nicolasbouliane.com/projects/all-about-berlin
    Gostaria que mais gente fizesse isso. Quando encontro materiais parecidos, faço questão de agradecer. Um me ajudou a atravessar a Coreia de bicicleta, e outro me ajudou a consertar um aparelho muito específico. É triste ver Google, redes sociais e IA explorando a céu aberto o trabalho dessas pessoas úteis e tirando delas a recompensa

  • Vou publicar em breve uma página web com o que descobri depois de passar vários dias investigando por falta de informação
    A publicação em si está demorando porque estou experimentando uma forma mais sustentável de fazer isso do que antes. Isso inclui, de algum jeito, ganhar dinheiro e tornar mais difícil para crawlers e serviços de “IA” copiarem tudo :(

  • Quando alguém dedica tempo para aproveitar algo que eu faço — escrever, cozinhar, desenvolver ferramentas — sinto um reconhecimento que me dá um grande ânimo
    Por outro lado, quando publico algo e aquilo desaparece no vazio, sem ninguém notar ou comemorar, fico desanimado. Mantendo uma conta no Medium por 10 anos, passei pelos dois lados, e agora não consigo parar porque escrever é a minha jornada e os leitores são volúveis. Aceito isso como uma espécie de termos de uso da criação

    • Os posts comuns do meu blog não recebem comentários
      A média provavelmente é de cerca de 1, porque os posts que recebem comentários normalmente têm 3 ou 4. Em 19 anos blogando, a maior descarga de dopamina foi ver este post chegar ao 1º lugar na primeira página do HN, e não acho que isso vá acontecer de novo
  • Ainda hoje estou escrevendo um post desses
    Nos últimos meses, tenho publicado apenas textos sobre coisas que descobri com esforço na minha área, Kubernetes, ou mergulhos bem profundos na leitura de código de codebases open source

  • Este tema acertou em cheio, e a vontade de escrever esse tipo de post cresce a cada dia. Eu simplesmente preciso fazer isso
    Recentemente tenho mexido com o Microchip PolarFire SoC[1], e eu já sabia que não havia muito material na área de design de FPGA. Mas a Microchip está em outro patamar em comparação com Xilinx/AMD, Lattice ou ferramentas open source. Travei muitas batalhas para conseguir fazer as coisas funcionarem, e só agora comecei a ter um fluxo de trabalho e a entender o chip. Hoje gosto bastante dele, e é um chip viável dentro do orçamento para quem quer entrar em co-design de hardware e software
    Toda vez que termino uma batalha, penso: “Droga, isso precisa ir para algum blog. Se ajudar uma pessoa no futuro — até mesmo eu mesmo no futuro — já é uma grande vitória”. Mas até agora, meu lado preguiçoso e um pouco assustado venceu
    O inglês não é minha língua materna, então fico pensando: e se eu não escrever bem o suficiente? E se o que estou escrevendo for óbvio para todo mundo e só eu estiver apanhando com isso? E se um amigo acabar vendo e rir de mim? Mas tudo bem. Eu quero fazer isso, então preciso fazer
    [1] https://www.microchip.com/en-us/development-tool/mpfs-disco-...
    A última frase me lembrou “Roll the dice”, de Charles Bukowski. Talvez eu devesse lembrar disso com mais frequência: https://hellopoetry.com/poem/68266/roll-the-dice/

  • Hoje em dia, sempre parece que alguém já escreveu o texto que eu queria escrever. Então escrevo a minha versão
    A maioria dos meus posts de blog do começo foi inspirada por perguntas em fóruns públicos. Eu respondia lá, depois escrevia um post no blog e, a partir daí, passava a enviar o link daquele post. Meus posts do início dos anos 2000 mostram esses rastros
    Por exemplo, o texto sobre como abrir o navegador em tela cheia no IE5 fez um sucesso enorme: https://brajeshwar.com/2002/ie-50-full-screen-from-itself/