Executando verificação de segurança...
Em resposta a Ler documentação: como isso me ajudou a programar melhor!
4
kht

Concordo com alguns pontos, discordo de outros.

Concordo que ler documentação é importante. Mais que isso, é essencial, obrigatório ler pelo menos uma vez antes de usar qualquer coisa.

Um erro muito comum é a pessoa usar alguma coisa e reclamar que não aconteceu o que ela achava que deveria acontecer. E gasta horas tentando descobrir porque não está funcionando. Aí você vê na documentação e lá explica que essa coisa faz algo completamente diferente. Se tivesse lido antes de usar, não perderia esse tempo.

Documentação também é uma ótima referência para quando você não lembra direito algum detalhe (O que era esse terceiro parâmetro? Essa função faz o que se der erro?). Em vez de quebrar a cabeça e ficar na tentativa e erro, é muito mais simples consultar a documentação.

Mas eu discordo que "A leitura da documentação te torna naturalmente um especialista". Pra ser especialista tem que ter muito mais que isso, ler a documentação é apenas um dos muitos passos a serem dados. Até porque muita documentação só descreve o que algo faz e dá alguns exemplos sobre o mecanismo, mas ela não tem tudo que é necessário para te tornar especialista. Isso só vem com anos de experiência e estudo, a documentação é só uma parte disso - importante, claro, mas ainda sim, uma parte. Tem coisas que só se aprende na prática, que manual nenhum vai te explicar.

Também discordo sobre o w3schools. Esse site já foi pior, hoje em dia melhorou um pouco, mas eu ainda acho um dos piores. Claro que depende da tecnologia, mas eu geralmente encontro opções melhores. Por exemplo, para Java, Python e C#, a documentação oficial é muito boa. Para JavaScript, HTML e CSS, a MDN é bem completa e abrangente. Muitos frameworks possuem documentação oficial e tutoriais que são mais que suficientes. Claro que tem casos e casos, mas em geral, as linguagens e frameworks mais mainstream possuem algum material minimamente decente. Deixei de consultar o w3schools há tempos (às vezes eu volto lá pra conferir, e vejo que ainda prefiro os outros sites).

Apesar disso, de forma geral concordo com o ponto principal: ler documentação é um hábito que todo desenvolvedor deveria ter.

2
maniero

E aí pergunta no Stack Overflow algo que já está disponível para ela. O que não tem problema, se a pergunta for bem feita. Mas geralmente o mesmo motivo, de atitude, que leva a pessoa a não ler a documentação é o que leva a pessoa a fazer uma pergunta ruim no SO, ou outro lugar. è um problema de falta de comprometimento.

Ler a documentação de forma comprometida ajuda muito a pessoa programar melhor, evoluir, criar as condições para cosias mais importantes ainda que ler a documentação, que é o básico do básico, e que não costuma ser feito.

Ajuda até melhorar, espero, na interpretação de texto, que sinto estar cada vez pior. E se não melhorar, aí tudo está perdido. Eu semrpe falo que os maiores fundamentos que o programador precisa é matemática e comu nicação e expresão. Se a pessoa é ruim demais nisso, ela será igual em programação.

Docum entação não ensina a pessoa programar. Ela ensina como usar um mecanismo. Se ela for boa, em muitos casos não é. E pior, precisa aprender ausar documentação, porque em geral o exemplo está lá apenas para ilustrar o mecanismo, não é uma receita de bolo para copiar e colar e usar. A documentação pode ajudar a pessoa programar mais errado ainda, novamente, se ela não tiver a atitude certa.

Acreditar que a documentação torna alguém especialista camufla a real necessidade e tende fazer a pessoa se contentar com pouco, e evoluir pouco como consequência.

Escolher a documentação certa também é importante, e depende de experiência e aprendizado anterior, além de... interpretação de texto. O W3S nunca foi uma boa escolha, ainda que não causa tanto problema como causava antes.

Documentação estilo wiki são perigosas. Material em Português costuma ser pior que em Inglês, inckuyindo documentação. Exemplos bem claros são do PHP e a MDN.

De qualquer forma, se as pessoas passarem a ler documentação muda absurdamente o estado que estamos na área.

Farei algo que muitos pedem para aprender programar corretamente, gratuitamente. Para saber quando, me segue nas suas plataformas preferidas. Quase não as uso, não terá infindas notificações (links aqui).

1