grupy-sanca / curso-python

Curso Introdutório de Python do grupy-sanca
http://curso.grupysanca.com.br/
Other
20 stars 22 forks source link

Nomes significativos de variáveis #61

Open vccolombo opened 4 years ago

vccolombo commented 4 years ago

Olá novamente!

Eu estava pensando, na página sobre variáveis, na seção nomes de variáveis, o texto já começa com Bons programadores escolhem nomes significativos para as suas variáveis - eles documentam o propósito da variável.

Minha sugestão seria passar esse trecho para o fim dessa seção, e adicionar um pouco mais de conteúdo nele. Algo sobre como isso ajuda o você do futuro e outros programadores a entenderem o que seu código faz. Eu acredito que dar nomes significativos as variáveis é um tema muito importante para ser um bom programador e vale umas linhas a mais.

O contraponto seria que aumentaria a quantidade de conteúdo, talvez sobrecarregue o curso que é introdutório.

Qual a sua opinião?

heitorPB commented 4 years ago

Sua sugestão é criar uma seção no mesmo capítulo sobre boas práticas para nomear variáveis? Isso é algo bem importante e acho válido ter no material. Principalmente por ser introdutório, assim a pessoa já sai codando com elegância :sunglasses: Talvez citar o PEP8 tbm?

Não vejo problemas em aumentar o conteúdo nesse sentido.

@lamenezes, @zsinx6 que acham?

anasampa commented 1 year ago

Iniciei uma seção de boas práticas baseada na PEP8, na qual tem a dica de nomenclatura de função.