Использование сокращений в коде

При написании кода на Javascript я стараюсь как можно больше объяснять, чтобы код было легче читать, потому что Javascript по большей части не является типизированным языком. Давайте рассмотрим несколько простых примеров, используя акронимы, которые часто используют программисты: snafu и foobar.

Так, например, если у нас есть переменная в Javascript:

const snafu = "situation normal, all f***ed up";
const foobar = "f***ed up beyond all repair";

Если мы позже передадим этот код, кому-то может быть трудно вспомнить, что такое snafu и foobar, и, поскольку это не типизированный язык, им также будет несколько сложно искать значения этих переменных. С другой стороны, эти переменные довольно легко запомнить, и в сочетании с типизированным языком, таким как Typescript, их поиск должен стать намного проще, если мы их не помним.

Я также стараюсь ограничить количество аббревиатур максимум двумя. Так, например, у нас было:

const pn: Field;
const vn: ValidationContext;
const foobar: FooBar;
const snafu: Snafu;
const o: Object;

Сейчас все аббревиатуры начинают убивать продуктивность сданного разработчику кода. Читать легче:

const propertyName: Field;
const validationContext: ValidationContext;
const foobar: FooBar;
const snafu: Snafu;
const object: Object;

Так что в целом я думаю, что акронимы и аббревиатуры — это круто, но в определенных пределах. Конечная цель должна состоять в том, чтобы код был как можно более читабельным и простым для понимания.