Reflexão: lições de codificação

Por Mark Nichols

Uma das primeiras partes de Conselho fornecidas quando aprender ao código é comentar de modo que a pessoa que mantem o código (você ou alguma outra pessoa) possa com sucesso a manter. No artigo 10 dicas para Writing Cleaner e melhor código *, Joel Lee sugere que simplesmente comentar não é suficiente e pode realmente tornar-se pesado quando não feito corretamente. Ele dá a regra do polegar que "Os comentários existem para explicar por que um pedaço de código existe em vez do que o código realmente faz." 

Embora não seja um paralelo perfeito, há alguma verdade nisso quando se considera como fazer reflexões efetivas durante o processo de aprendizagem baseada em desafio (CBL). A reflexão é uma peça-chave do quadro CBL porque permite que o aprendiz pense profundamente sobre o processo e tome consciência de como eles tomam decisões e aprendem. Se cada vez que eu abordar um desafio eu me tornar mais consciente dos meus processos de pensamento e tendências, o melhor aluno que eu vou me tornar. Ao me tornar um aluno melhor, desenvolvo melhores soluções. 

No entanto, muitas vezes reflexões no processo CBL se tornam uma narrativa básica da experiência. Primeiro, fizemos isso, então fizemos isso, e finalmente fizemos isso. Embora seja necessário haver alguma descrição do que aconteceu (o código), a parte mais importante é fazer comentários eficazes. Por que eu fiz isso? O que aconteceu quando eu fiz isso? Como isso impactou os participantes? Como eu me sentia sobre isso? E se eu tentasse outra coisa? O que posso fazer diferente da próxima vez? Este reflexivo comentando sobre o código de nossas experiências vai nos ajudar (mentores e estudantes) se tornam melhores aprendizes e praticantes da CBL. Se não refletirmos ou simplesmente descrevermos nossas atividades, nunca desenvolveremos os profundos insights que nos ajudarão a tornar-nos melhores aprendizes e professores.

* https://www.MakeUseOf.com/tag/10-tips-Writing-Cleaner-Better-Code/