Давать названия вещам — задача не из лёгких! Вот 10 простых советов, которые помогут.

В этом видео 30 лет опыта кодирования превращаются в практические соглашения об именовании, которые разработчики могут применять в TypeScript, JavaScript, React и бэкенд-коде с помощью Convex. В нём объясняется, когда использовать префиксы, такие как find/get/is/list, как кодировать единицы измерения (например, мс, пиксели) и как различать временные метки и длительности. Также рассматривается именование файлов и компонентов для крупных проектов и то, как единообразные имена улучшают читаемость, удобство поддержки и инструменты с поддержкой ИИ. Идеально подходит для инженеров, которым важны чистые API, предсказуемая DX и меньше ошибок обработки нулевых значений.

Временные метки
[00:00:00] Холодное открытие: две сложные вещи
[00:00:31] Почему именование важно для людей и ИИ
[00:01:37] find vs get, допустимость значений NULL и помощник Ensure
[00:03:10] Замечание по выпуклому именованию: get vs find и getOrThrow
[00:04:15] Предпочитайте подробные имена; правила краткости, основанные на области действия
[00:05:08] Суффиксные единицы измерения (мс, px, процент) для ясности
[00:05:56] Именование файлов и папок; один компонент на файл
[00:06:47] Временные переменные: At (мгновение) vs Ms (продолжительность)
[00:07:37] Булевы функции с is
[00:07:56] Массивы со списком; Избегайте get для коллекций
[00:08:34] Используйте my* для логики, доступной текущему пользователю
[00:09:03] Быстрые действия: создание, обновление, выборка, has, разбор
[00:10:01] Заключение: соглашения как естественный язык
[00:10:25] Упоминание в конце и первой части

Ресурсы

Часть 1 серии:    • Your code is not readable, here's how to f...  
Документация Convex: https://docs.convex.dev/home
Ссылка на плейлист «Советы Майка»:    • Your code is not readable, here's how to f...  

Хештеги
#соглашениянаименования #typescript #javascript #react #convex #cleancode #readability #удобство обслуживания #опыт разработчика #бэкенд #API #лучшие практики #проектирование ПО