Есть ли у вас документация проекта для командной работы?
И в каком виде эта документация и какой детализации.
Суть вопроса в том, что есть большой проект (более 300 тыс. строк кода) и приходит на него новый разработчик: ему говорят - запили работу с чёрным списком IP-адресов. Он делает в классе BlackIp свой метод проверки ip на корректность и т.д., ему потом говорят нет чувак, у нас такая проверка на корретность ip уже есть в классе AllCheck например. ORM у кого есть своя в проекте вы пишете к ней какую-то документацию или примеры основных запросов?
Какого уровня детализации нужна документация и что в ней было бы правильно описать? Структуру папок, классов, кто за что отвечает, методы классов?
Или вам пофигу и вы никогда не пишете никакую документацию что бы новички вас не подсидели?
Если уже 300+kLOC, а вопрос про документацию все еще будоражит умы, смиритесь с тем, что проект проще и дешевле выкрасить и выбросить. Все равно "опытные сотрудники" давно и прочно застолбили свою незаменимость, и теперь их уже никакими коврижками не заставить написать осмысленную доку... да это и объективно не так просто, как кажется. Короче, поздно пить Бoржоми (((
В крупных проектах, задачи ставятся через багтрекер, в котором в тикете должен быть desigon solution, заапрувленный архитектором (или кто у вас контролирует архитектуру проекта в целом).
Там должно было быть указание, нужно ли создавать новый метод, или есть готовый, написанное опытным сотрудником.
P.S. Джуниорам и даже мидерам задание нужно всегда уточнять. Сеньор должен сам догадаться и уточнить как решать таск.
Комментарий даёт представление о том, на что мы смотрим именно сейчас, но никак не говорит о том, есть ли нужная штука в другой части системы, написанной год назад