Eu exitei bastante em iniciar esse conteúdo por diversos motivos e um desses motivos é que eu estou na minha segunda experiencia profissional, e do ponto de vista logico eu ainda sou um iniciante, mas queria compartilhar com vocês uma experiencia recente que tive trabalhando pela primeira vez com um time de especialistas em uma grande empresa e também apresentar alguns fatos interessantes e algumas sugestões que me fizeram aprender a programar de fato.
1) Documentação é muito superior a assistir um curso
É obvio que isso não se aplica a tudo, não é uma regra geral de fato, mas acredito que todo programador com experiencia, já assistiu algum curso e pensou "esse cara ta apenas lendo a documentação em voz alta" e bom acredito que de fato isso aconteça na maioria dos casos, existem algumas exceções onde algum professor com uma didática diferente consege explicar um fato que parecia confuso, mas ai que entra a questão desse topico
a documentação tem que ser a sua primeira opção sempre, a documentação tem que ser sua primeira ferramenta de busca, em seguida artigos, vídeos etc. O argumento por traz disso surge do fato de que no mercado de trabalho o foco é solucionar problemas de forma limpa, rápida, escalável, e sofisticada. Quando alguém assiste um video ou um curso como primeira opção, ela está abrindo porta para códigos desatualizados, destoante da regra de negocio, e isso implica na segunda questão que vou falar agora.
2) Documentação tende a sempre estar atualizada
Esse fato se aplica no geral as documentações oficiais, existem muitas documentações boas na internet mas é sempre importante verificar as datas de atualizações. Como eu havia abordado no tópico anterior, é ideal que no mercado de trabalho o sistema esteja sempre utilizando soluções modernas, isso se aplica a situações como por exemplo:
vamo supor que você esteja com um problema que foi solucionado pela documentação há anos, vai bastar uma rápida lida no contexto que você esta inserido e pronto problema solucionado da forma mais moderna possível.
3) Dicas uteis para começar a criar o habito de ler documentação
Entenda a documentação como uma receita, você ler, interpreta, pega os ingredientes e aplica, se queimar ou não ficar bom.... então nesse caso não estamos falando de comida você terá que ler e aplicar de novo.
Normalmente as documentações costumam ter uma área para tutorial,e uma de fato para a documentação, o tutorial costuma dar uma breve introdução, e ensina normalmente a fazer o setup da tecnologia que você esta utilizando(aqui você já teria que assistir umas quatro ou cinco aulas de algum curso meia boca por ai).
A documentação em si costuma ter uma parte onde explica e demonstra os conceitos, e uma outra parte com descrições de cada funcionalidade especifica da tecnologia, a demonstração de conceitos é perfeitamente util para aprender, porem oque me ajuda no dia a dia são as descrições das funcionalidades. Um exemplo disso é minha constante pesquisas na documentação do django sobre models e querySet, coisas que não faz sentido pra mim entender o conceito pôs são simples e facilmente entendível , mas a utilização e os parâmetros fazem mais sentidos pro meu dia a dia principalmente em questões especificas da regra de negocio do projeto, onde cabe a mim desenvolvedor procurar nas funcionalidades existentes formas de se adaptar á minha realidade e ao oque preciso fazer.
4) Como identificar se a documentação é boa ou ruim
Esse ponto deixei por ultimo por um motivo obvio, ele é completamente pessoal e sim eu ja vi gente defendendo ou criticando de forma injusta documentações só pelo fato de não ter entendido a tecnologia,Mas eu vou separar alguns pontos que pessoalmente fazem eu digerir melhor uma documentação.
> Documentação que tem exemplos claros e objetivos
Um exemplo de documentação com bons exemplos é a do React Native que tem uma clareza na interface do site, e além disso ótimos sandbox onde você consegue entender facilmente oque cada parte daquele código ta fazendo.
> Documentação com uma guia simples
Um exemplo de documentação que apesar de boa tem uma guia completamente caótica é a do django, apesar de super completa, ela faz você facilmente se perder em tantas possíveis direções e diferentes paginas do mesmo assunto que a documentação vai, normalmente a documentação oficial é essencial mesmo que desagradável que você leia, porem em situações especifica procure documentações que mesmo não sendo a oficial são mais digeriveis. Um exemplo de ótima documentação alternativa que é facilmente inteligível é a w3schools.
A principal diferença de um especialista pra um Júnior
Obviamente existem mais diversos motivos para se ler documentação oficial ou não oficial, mas em geral com essa minha experiencia profissional com especialistas eu cheguei a conclusão que de fato o poder de conhecimento e que aquele profissional tinha em relação aos demais era exatamente oque esse artigo aborda: A leitura da documentação te torna naturalmente um especialista. Espero que esse artigo instigue aos mais novatos á criarem esse habito e que ajude de alguma forma quem ainda não teve esse interesse por ler documentações.