> For the complete documentation index, see [llms.txt](https://weekly-essay.mikey.wang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://weekly-essay.mikey.wang/pt-br/2022/w08-how-to-write-good-code.md).

# W08-Como escrever bom código

Na semana passada, discutimos esse tema na equipe. Quero ampliar a reflexão. **Há uma regra geral: melhorar continuamente a qualidade das fontes. Escrever bom código também é aprender e praticar, e encontrar boas fontes é um motor de crescimento.**

No começo da carreira, eu lia muitos canais públicos do WeChat. Cada artigo parecia uma descoberta: “Que explicação boa, preciso salvar.” Aos poucos, encontrei comunidades com conteúdo mais sistemático e percebi que muito vinha de fora, de lugares como Medium e Google Developers. Passei um tempo gostando de traduzir. Depois, segui listas de livros e recomendações de profissionais mais experientes. Ao ler alguns clássicos, percebi que muito do conteúdo anterior era fragmento: trecho, ampliação ou aplicação de um capítulo. Esses livros raramente são novos e costumam ter várias edições, mas continuam renovando a leitura, como *O programador pragmático*, *Refatoração*, *O design do design* e os livros de Yukihiro Matsumoto.

No início, eu montava um quebra-cabeça: reunia fragmentos, explorava e formava teorias, para depois descobrir que reinventava a roda. Mais tarde, passei a plantar uma árvore: construir uma estrutura de conhecimento e pendurar as informações nos galhos depois de formar o tronco. Quando conseguimos avaliar informações e convertê-las em prática, o que recebemos no cotidiano ganha muito mais valor. Aprendemos a reconhecer truques pequenos, que merecem apenas um sorriso, e soluções simples e profundas, que merecem estudo.

Isso explica por que melhorar as fontes. Mas o que é uma fonte de qualidade? Novas mídias, como canais do WeChat, são inferiores aos livros? Certamente não. Cada canal tem suas especialidades; qualidade é só uma dimensão. Classificá-los por qualidade seria injusto. Faz mais sentido avaliar marcas, pessoais ou institucionais. Boas marcas dificilmente entregam conteúdo ruim, pois refletem esforço de seleção, edição e revisão. Exemplos são Aotu e Qiwu nas comunidades e Turing, O’Reilly, Huazhang e Zhanlu nas editoras.

Não há hierarquia absoluta nem um canal todo-poderoso. Dar a um meio uma função além de suas características leva a desvios. Em *Divertindo-nos até a morte*, a febre da televisão levou pessoas a querer reconstruir a educação com ela, mas muitas tentativas de ensinar por entretenimento fracassaram. A televisão oferece leveza e diversão; não se deve esperar que assuma todas as responsabilidades sociais. Depois dela, vivemos os portais e as novas mídias móveis. Cada época acrescentou uma opção. A lógica não é quem deve substituir quem, mas quem serve melhor a quê.

Wan Weigang também defende ler conferências de ponta e artigos acadêmicos, as fontes de maior qualidade. Concordo, mas acho a posição fundamentalista demais. Sua perspectiva tende à da elite científica. Na introdução de seu curso geral de mecânica quântica, uma frase me marcou: disciplinas com “ciência” no nome não seriam ciências; o nome revelaria insegurança, como em ciência da computação.