poorly commented function
[/ˈpɔːrli ˈkɒmentɪd ˈfʌŋkʃən/]
noun phrasepl: poorly commented functions
função mal comentada
1. A computer function or subroutine that lacks adequate or clear explanatory comments in its source code, making it difficult for other developers to understand its purpose, logic, or implementation
The poorly commented function made it hard for the junior developer to understand what the code was supposed to do.
A função mal comentada tornou difícil para o desenvolvedor júnior entender o que o código deveria fazer.
2. Code with insufficient documentation that fails to explain complex logic, parameters, return values, or edge cases
We spent hours debugging the poorly commented function because there was no documentation of the expected input format.
Gastamos horas depurando a função mal comentada porque não havia documentação do formato de entrada esperado.
In software development culture, both in Brazil and the USA, writing well-commented code is considered a best practice and sign of professional development. Poorly commented functions are often cited as a pain point in code reviews and are associated with poor code quality. In Brazilian development teams, this is frequently referenced during 'code review' sessions (revisão de código) as a quality control issue. The term reflects the shared international programming culture where code maintainability is highly valued.
Related Idioms & Phrases
code that speaks for itself (antonym concept)
technical debt
spaghetti code (related concept for hard-to-follow code)
Look up more words on Fala2Me
The free English-Portuguese dictionary with real Brazilian accents, NYC slang, conjugator and more
Open Fala2Me →