Challenges in writing a programming book

O autor conta que a ideia de escrever um livro sobre frameworks cresceu a partir de uma série de posts e acabou virando “The Framework Field Guide”, uma trilogia que ele está tornando gratuita. Para isso, passou mais de dois anos entre organizar o material, criar o site do livro, refazer a plataforma de blog, escrever o primeiro volume e preparar exemplos de código, tudo enquanto mantinha o trabalho como líder de equipe de engenharia.

Fichamento

#

• Escrever um livro é lento e envolve bem mais do que redigir capítulos, porque o projeto acabou exigindo reorganização de conteúdo, site de marketing, plataforma de publicação, revisão e exemplos de código.
• O autor diz que vendas de livros são difíceis e que o esforço pode render menos do que consultoria, além de obrigar a pensar em preço baixo, que desvaloriza o trabalho, ou alto, que afasta leitores.
• Ele resume que é preciso escrever por motivação própria e manter resiliência, porque o resultado pode valer o esforço.
• Desenvolvedores costumam ler de relance, então artigos funcionam melhor quando são curtos, divididos com imagens, destaque em negrito e itálico, listas e código.
• Títulos de seção precisam dizer com clareza o que será aprendido, porque títulos divertidos podem ser ignorados.
• O autor recomenda comentar o código dentro do próprio bloco, já que muita gente copia e cola exemplos e aprende ajustando o que vê.
• Ele afirma que conteúdo em vídeo tende a ter retorno maior para desenvolvedores do que texto, citando a diferença entre as visualizações de um artigo seu e um vídeo de Theo no YouTube.
• No fim, ele diz que produzir conteúdo é trabalhoso, mas que publicar um livro pode melhorar o currículo, trazer orgulho e ajudar outras pessoas a aprender.