Caindo na Real - Palavras

Iniciamos nossa décima primeira postagem, de um total de 16 postagens, acerca dos 16 cápitulos do livro "caindo na real", escrito pela 37 Signals, empresa que criou o framework de desenvolvimento de software Ruby on Rails. Aqui você encontra o livro para leitura: https://bit.ly/39IQf7p

Nessa décima primeira postagem, nós discutiremos os conhecimentos apresentados no décimo primeiro cápitulo, que fala sobre Palavras ou Documentação. Diferente dos demais cápitulos, este cápitulo nos trás em 4 páginas, uma série de sábios conhecimentos e verdades, que precisamos conhecer/pensar e aplicar em nosso cotidiano profissional. A única frase que gostaria de compartilhar a minha opinião com vocês, é esta daqui:

Construa, não escreva coisas que ninguém vai ler. Use textos reais!

O texto nos trás apontamentos que indicam que devemos construir os produtos e não apenas escrever textos/documentação. Este tema é um tanto polêmico, pois sabemos que bom software carrega consigo boa documentação, porém os autores são pragmáticos acerca de textos. O que devemos carregar destes apontamentos, é que existem outras formas de construir e também documentar algo, que não seja apenas texto. Sendo assim, procure utilizar o máximo de artefatos que possuir, que facilitem a documentação sobre cada parte que forma a aplicação.

O que você pensa sobre tudo isso? Chegou a ler a parte que fala sobre palavras/documentação do livro? Tem algo importante que não comentei e que precisa ser comentado? Gostaria de ouvir sua visão/opinião sobre tudo isso. Se for do seu interesse, você pode dar uma espiada nas minhas anotações/sínteses sobre o livro, em meu Notion público: https://bit.ly/3HHVr7S Até o próximo episódio/cápitulo.