Посвящается Gitlab
На текущей стадии развития я абсолютно убежден, что весь процесс разработки — про общение. Общение с коллегами, общение с бездушными машинами и компиляторами, общение с создателями бездушных машин и компиляторов, общение с пользователями, общение со сторонними разработчиками, с менеджерами, с уборщицами, с кофеваркой на кухне, со всеми на свете.
Проблема этого вида общения (как и в принципе любого другого) -- трудность и (а иногда и невозможность) донести свою мысль в какой-бы то ни было вербальной форме. Но это определенно способность, которую можно тренировать, хотя очевидно и не так легко, как алгоритмические проблемы на Leetcode.
Проявляется эта проблема примерно везде: от документации до описания ошибок, от разгоров у кулера до обсуждения промоушна и карьерного развития.
Так вот.
Есть почему-то субъективное ощущение, что некоторые разработчики других разработчиков считают людьми второго сорта (но это отдельная история конечно). Т.e. лендинг >> API, текст на странице >> описания ошибок методов, хотя на самом-то деле это все просто разный способ получения одной и той же информации. И не совсем очевидно, почему приоритет отдается чему-то одному, особенно в продуктах, которые изначально создавались для разработчиков.
Помимо превращения Gitlab’a в AWS по числу кнопок/подменю/подразделов/появлению внуков пунктов одних выпадающих меню из других, прослеживается (иногда правда, чуть в стороне от happy-path’a закоммитил -> отревьюил -> смержил -> забыл) явное принебрежение своим же API.
Вчера я потратил некоторое время на то, чтобы понять ошибку при попытке запушить helm-chart в Gitlab image registry. Ошибка:
Error: server message: insufficient_scope: authorization failed
На первый взгляд, черным по белому написано, что ошибка — в запросе к чему-то из-за отсутствия прав. Но на самом же деле, Gitlab обязательно привязывает артефакты к какому-то конкретному репозиторию, и эта ошибка говорит лишь о том, что я сделал опечатку в пути репозитория и Gitlab не может найти, куда привязать мои артефакты (helm chart в данном случае). Понятно ли это из сообщения? Ни разу.
Объясняйте пожалуйста своим пользователям по-человечески, когда что-то идет не так и что вы от них хотите на самом деле.
Между тем
предложению поправить это и общаться нормально — 4 года.