Манифест разработчика

Я уверен, в каждой команде разработки должен быть свой манифест — Манифест разработчика.

Это совокупность норм и правил работы в команде и работы с кодом. Это не гайдлайн по оформлению кода — это выше по смыслу. Многие приложения управляются манифестом. Почему бы и команде не управляться им?

С манифестом нужно знакомить человека на этапе собеседования, потому как он должен откликаться новому члену команды — с одной стороны. А с другой стороны, пока человек не пришел в команду, он не может посмотреть на кодовую базу проекта, и другие внутренние стороны. Следовательно не может сделать вывод насколько используемые подходы написания кода и работы соответствуют его ожиданиям.

Если манифест подходит по духу и смыслам, то велика вероятность того, что и код, как результат работы команды согласно этому манифесту, будет соответствовать ожиданиям. Таким образом, кодовая база показывается другому человеку, не показывая себя. Магия. Но это работает, т.к. сначала смыслы, структура потом.

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

Манифест разработчика

• Все должно быть просто. Сложность — признак архитектурной ошибки.
• Рассчитывай время работы над задачей исходя из оценочного. Всегда есть несколько решений — подбери оптимальное.
• Если время выполнения задачи превышает время оценки более чем на 30% — сообщить лиду или проект-менеджеру.
• Если возникли трудности с решением задачи — обратись за помощью или советом к товарищу-разработчику.
• Однако, не расходуй время коллеги просто так. Разбери возможные варианты, затем вынеси на обсуждение. Цени время товарища.
• Развивайся сам и помогай товарищу.
• После написания кода задай себе вопрос: «Этот код устойчивый?».
• После окончания работы задай себе вопрос: «Мне нравится, что я сделал?».
• С каждой новой задачей делай код меньше и проще.
• Не создавай сущности и абстракции без явной потребности в них.
• Избегай «лоскутное одеяло» в проекте, соблюдай принцип ритма и структуры.
• Если что-то не нравится в существующем коде, продолжай в единой логике. Выдели время на анализ и устранение спорных мест в коде.
• Не будь безразличным к тому, что ты делаешь.
• Соблюдай принципы и концепции трактата «Код, который не может не работать».