Трудно писать код для компьютеров, но еще труднее писать код для людей

Писать код для компьютера достаточно сложно. Вы берете что-то большое и нечеткое, какой-то большой неопределенный бизнес-результат, которого вы хотите достичь. Затем вы рекурсивно разбиваете его на части и обдумываете все возможные варианты, пока не получите четкие логические утверждения, которым может следовать компьютер. Компьютеры очень хорошо умеют следовать логическим утверждениям.

А теперь давайте поднимемся на ступеньку выше. Давайте попробуем написать код для людей!

Я должен пояснить, что я имею в виду. Я говорю о коде, с которым будут взаимодействовать другие люди. Точнее, я говорю об искусстве создания радостных фреймворков, библиотек, API, SDK, DSL, встроенных DSL или, может быть, даже языков программирования.

Писать такой код гораздо сложнее, потому что вы не просто говорите компьютеру, что делать, но и работаете с ментальной моделью вашего кода для другого пользователя. Теперь это равная часть компьютерной науки и психологии рассуждений, или что-то в этом роде. Как заставить этого человека понять ваш код?

Статья: https://erikbern.com/2024/09/27/its-hard-to-write-code-for-humans.html