Já vi várias discussões sobre esse assunto, muita gente dizendo que um bom livro é melhor do que a documentação oficial, e vice-versa. Sabe-se que existe muita documentação ruim, incompleta e superficial; mas também é fato que existem muitos livros no mesmo nível, e ainda existem livros que nada mais são do que a documentação com um maior volume de exemplos e algumas explicações mais claras.
Uma documentação é a forma utilizada para apresentar e especificar o funcionamento e os recursos de alguma ferramenta ou linguagem. Ela é objetiva, descreve pontualmente o funcionamento e os recursos, um a um, e costuma trazer alguns exemplos de aplicação do recurso ou funcionalidade
O livro, assim como a documentação, apresenta e especifica o funcionamento e os recursos de alguma ferramenta ou linguagem, mas com uma abordagem totalmente diferente. Ao invés de ser pontual e altamente técnico, ele apresenta esses conceitos de maneira mais descritiva e com linguagem mais simples e menos técnica, com um maior volume de exemplos e detalhes, permitindo que alguém sem nenhum tipo de conhecimento da ferramenta ou linguagem possa começar a utilizá-la a partir das primeiras páginas.
Assim como não há livro pra tudo, também não há documentação, e em muitos casos não há nenhum dos 2 e o jeito é aprender a usar a ferramenta ou linguagem sozinho, na base da "tentativa e erro".
A documentação é a base de conhecimento e fonte de pesquisa para os profissionais que fazem uso da ferramenta ou linguagem. É mais rápido você encontrar uma informação na documentação do que em livros, uma vez que a documentação, na maioria dos casos, está disponível na internet, e o livro você precisa comprar, ou ficar procurando na internet pra fazer o download ou então arrumar emprestado com um amigo. Em contra-partida, o livro pode trazer informações que são mais fáceis de ser compreendidas, facilitando assim o aprendizado.
Como a documentação é mais pontual e específica, traz tudo bem divido, ela permite maior agilidade no processo de localização da informação, enquanto o livro traz diversas informações em um único capítulo e pra ter agilidade você terá que conhecer bem o livro, e isso implica em ter lido pelo menos umas 2 vezes; mas pode ser que o livro use uma liguagem e didática que tornam a compreensão melhor.
Trazendo o assunto para o cenário do desenvolvimento de softwares, onde temos uma série de linguagens, frameworks, libraries, extensions e muitas outras ferramentas, vamos encontrar muitos livros, em diversos idiomas, de vários autores, com abordagens diferentes e nenhum falando 100% do assunto, tão completo quanto a documentação (que nem sempre é completa também).
Eu estaria totalmente equivocado dizendo que um é melhor que outro, pois na verdade o que importa mesmo é que seja extraído o máximo de conhecimento tanto do livro quanto da documentação. No meu dia-a-dia eu faço uso de documentações e também de livros, pois acontece do conteúdo de um não ser tão esclarecedor, ou eu precisar de uma informação que vai além do conceito técnico. E creio que isso aconteça com vários outros programadores.
Costumo dizer para meus alunos que no início o livro - desde que seja bem escolhido - pode ser mais eficiente no aprendizado do que a documentação, por ser menos técnico e mais detalhista; mas depois de um tempo, quando chegar em um nível mais avançado, a documentação será mais eficiente, pois é impossível saber 100% dos recursos de uma linguagem ou ferramenta. E mesmo que se saiba, sempre surgem dúvidas.
Como o título desse artigo é uma pergunta, não posso terminar sem respondê-la, então deixo a minha resposta aqui e aguardo a sua resposta nos comentários.
Entre a documentação e o livro, o melhor é aquele que esclarecer a sua dúvida ou resolver o seu problema, e principalmente fizer com que seu conhecimento evolua.
😕 Poxa, o que podemos melhorar?
😃 Boa, seu feedback foi enviado!
✋ Você já nos enviou um feedback para este texto.