Comments 7
Я всегда думал, что манифест и есть краткое описание или даже оглавление.
А если надо копать глубже — то разбирать тему.
Кмк проблема не в манифестах, они то свою задачу выполняют. А проблема в тех, кто неправильно этими манифестами пользуется. В том числе, принимает какие-то решения, не понимая контекст.
Ввести человека в контекст и завершить манифестом — отличная идея. А вот зайти с манифеста и потом пытаться объяснить контекст — не очень (и это следует аж из строения мозга).
Разумеется, можно попробовать составить его так, чтобы человеку стало любопытно, что является бэкграундом манифеста, но вызвать любопытство — нетривиальная задача. И в результате можно попасть в ситуацию, когда вред от манифеста превышает его пользу.
Начиная с 10 заповедей.
Да и документацию можно трактовать по разному.
А контекст у разных людей свой. Поэтому трактовки могут быть вплоть до полной противоположности.
Мне кажется, манифесты хорошо бы работали, если бы авторы предваряли оные краткой аннотацией «условий, в которых манифесты работают». Хотя бы из личного опыта. Типа:
ММММ (SOLID) — Моноответственность, Модифицируемость, Мелкость, Метафоричность. Букв четыре, потому что любому идиоту ясно, что «O» и «L» — это вообще одно и то же. Добавьте Меняемость после Модифицируемости, если вам так не кажется.
Если бы авторы начали с того, что это было придумано (и как-то работает) для языков, заранее спроектированных с учетом необходимости изобретения способов борьбы с раздутыми объектами типа «God», множественными наследованиями, извращенными инъекциями зависимостей, и соблазнами просто добавить пару методов по месту, вместо еще пятнадцати файлов общим размером в три мегабайта — было бы просто, понятно, и все бы согласились.
Да, мы свернули куда-то не туда, десятилетиями слишком вольно трактуя вскользь брошенную мысль Алана Кея про объекты и сообщения. Теперь надо изобрести способ сделать нашу жизнь чуть менее болезненной. Вот вам ММММанифест.
Очень помогает, когда тебе начинают рассказывать: «вот тут мы можем сделать так, и вот так и еще сюда вот это прикрутим и вообще красота получится». А ты слушаешь и думаешь: «что тут вообще происходит...».
Попросить начать с того, какую проблему мы решаем — очень помогает войти в контекст. Кстати, что забавно, иногда люди затрудняются ответить на этот вопрос. А после ответа на него, часто выясняется, что для решения проблемы «делать это и прикручивать вот это» — вообще было не нужно.
Манифесты и карго-культы