Code Smell 277 - UPPERCASE Acronyms
Maximiliano Contieri
Engineering Manager@Avature | CS Teacher@UBA | Book Author@O'Reilly | MaximilianoContieri.com
Avoid Jumbled Acronyms for Clarity
TL;DR: Treat acronyms like normal words to improve human readability.
Problems
Solutions
Context
Acronyms in uppercase (like JSON, XML, REST) in camel case break the natural reading flow.
You may think sendJSONRequestOnHTTPREST is a clear name, but it makes your code harder to read, especially when you string multiple acronyms together.
Treating acronyms like normal words in camelCase (sendJsonRequest) keeps your code more readable and easier to understand.
Sample Code
Wrong
class NetworkConnector {
func validateXMLFile() { /*...*/ }
func sendJSONRequest() { /*...*/ }
func parseURLResponse() { /*...*/ }
func setRESTAPIURL() { /*...*/ }
func retrieveHTTPStatusCode() { /*...*/ }
func updateDBConnection() { /*...*/ }
func configureSSLCertificate() { /*...*/ }
func setHTMLTemplate() { /*...*/ }
func generateUUID() { /*...*/ }
func connectViaFTP() { /*...*/ }
}
Right
class NetworkConnector {
func validateXmlFile() { /*...*/ }
func sendJsonRequest() { /*...*/ }
func parseUrlResponse() { /*...*/ }
func setRestApiUrl() { /*...*/ }
func retrieveHttpStatusCode() { /*...*/ }
func updateDbConnection() { /*...*/ }
func configureSslCertificate() { /*...*/ }
func setHtmlTemplate() { /*...*/ }
func generateUuid() { /*...*/ }
func connectViaFtp() { /*...*/ }
}
Detection
[X] Semi-Automatic
It would help if you had a smart thesaurus.
To detect this smell, look for methods or variable names with uppercase acronyms that disrupt readability.
Code reviewers or linters can also flag camelCase inconsistencies.
Tags
Level
[X] Beginner
AI Generation
Modern AI code generators may produce inconsistent acronym casing.
Always review and adjust their output to match your conventions.
AI Detection
With prompts, AI can fix these naming issues and suggest improvements based on camelCase style.
领英推荐
Try Them!
Remember: AI Assistants make lots of mistakes
Without Proper Instructions
With Specific Instructions
Conclusion
Naming conventions are key to readable code.
Treat acronyms like normal words, and avoid uppercase blocks to keep your code easy to understand.
Relations
More Info
Disclaimer
Code Smells are my opinion.
Credits
Photo by Csabi Elter on Unsplash
Thank you @Daniel Moka for this tip.
Simple can be harder than complex
Steve Jobs
This article is part of the CodeSmell Series.