Comments (1)
Oi, amei a proposta do projeto! Porém tenho uma sugestão, senti falta de comentários no código. Por o código ser um pouco extenso seria interessante ter comentários em linhas especificas informando o que esta sendo executado naquele bloco de instruções.
Parabéns pela dedicação, um abraço <3!
Oi, Thaynara! Obrigada pelo feedback!! <3
Então, sobre os comentários, é o seguinte: eu sigo muito os conceitos do código limpo, que tem algumas premissas, como:
- nomear muito bem as variáveis, funções e classes;
- fazer funções pequenas
- sempre deixar o código mais limpo e legível etc
Uma dessas premissas é justamente não comentar no código (pelo menos não excessivamente). Isso porque, quando a gente atualiza o código, é muito comum esquecermos de atualizar os comentários (e eu já fiz muito isso), principalmente se tratando de funções.
Código limpo também diz muito sobre a legibilidade, ou seja, se o código é compreendido (esse eu tento aplicar e nem sempre consigo rs). Um código bem escrito, na verdade, dispensa comentários, acredita? Por isso meus códigos geralmente não tem comentários heheh.
De toda forma, muito obrigada pelo retorno. Se você quiser que eu te explique melhor alguma parte do código, pode me chamar!!
from acapro.
Related Issues (12)
- AMEEEI! HOT 1
- Sugestão HOT 1
- Um detalhe muito pequeno HOT 1
- Boa experiência HOT 1
- Feedback HOT 1
- Muito bommm!! HOT 1
- Pequena melhoria nos inputs de nome autor e ano de realização do artigo em evento HOT 1
- Incrível HOT 1
- Sugestão de deslocamento de informação HOT 1
- Missing Read.me HOT 1
- Sugestões. HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from acapro.