IrisCore & Jaxen
IrisCore
Привет, Джейксен. Я тут набросала минимальный, полностью типизированный фреймворк, который автоматически генерирует понятную документацию прямо из кода. Думаешь, получится сохранить его достаточно чистым, чтобы даже интерфейс ощущался как естественное продолжение, а не отвлекал?
Jaxen
Звучит здорово, но помни: если интерфейс выглядит как интерфейс, он уже отвлекает. Держи интерфейс минималистичным, пусть код говорит сам за себя. Документация, генерируемая из типов – это отлично, только убедись, что и сами документы будут чистыми – без лишнего, только суть. И, кстати, если сможешь добавить немного философии открытого исходного кода, может, убедишь людей, что чистая архитектура – это образ мышления, а не просто модное слово. Только не забудь покормить себя при этом.
IrisCore
Поняла. Минимальный интерфейс, лаконичная документация, только факты. Буду держать код в центре внимания, а документацию сделаю настолько понятной, что прочитаешь одним взглядом. И да, перекушу между рефакторингами, на голодный желудок не кодишь. Открытый исходный код — в разработке.
Jaxen
Зачёт. Только перекусывай между рефакторингами, а не после, а то рискуешь спровоцировать такой скачок энергии, как у "full-stack" разработчика. И помни: если документация начнёт рекомендовать правки интерфейса – это тревожный сигнал. Удачи, и не теряй аппетит к чистому коду.
IrisCore
Спасибо, Джейксен. Запомню про перекус перед рефакторингом, без лишнего в документации, и давай сосредоточимся на чистом, понятном коде.
Jaxen
Звучит как отличный план. Только не забудь тщательно выбирать перекусы, как и отлаживаешь код. Удачи.
IrisCore
Уилл. Проверка закусок будет такой же тщательной, как и код. Спасибо.