Using your local language is a great idea because domain naming is easier. Not
TL;DR: Stick to English. Always.
Write in English
Rename Domain Concepts to English
All programming languages are written in English.
Unless for a few failed experiments during the 90's all modern languages use English for their primitives and their frameworks.
if you wanted to read or write in medieval Europe, you had to acquire a new language at the same time. Writing meant Latin.
This is true for programming languages nowadays.
I am not a Native English speaker.
My code (tries to be) in English.
const elements = new Set(); elements.add(1); elements.add(1); elements.size() = 1 //This is the standard set var moreElements = new MultiConjunto(); //We defined a multiset in Spanish //because we are extending the domain moreElements.agregar('hello'); moreElements.agregar('hello'); //'agregar' is the Spanish word for 'add' moreElements.size() = 2 //Since it is a multiset //elements and moreElements are NOT polymorphic //I cannot exchange their implementation
const elements = new Set(); elements.add(1); elements.add(1); elements.size() = 1 //This is the standard set var moreElements = new MultiSet(); //We defined a multiset in English moreElements.add('hello'); moreElements.add('hello'); moreElements.size() = 2 //Since it is a multiset //elements and moreElements are polymorphic //I can exchange their implementation anytime
Most IDEs and linters have a thesaurus.
We can search for foreign words.
Don't mix Non-English domain words with English primitives.
Even when Mapping your real-world entities, use plain English.
A programming language is a tool that has a profound influence on our thinking habits.
This article is part of the CodeSmell Series.