Russian Association of Software Architects
4.34K subscribers
83 photos
8 videos
14 files
293 links
Канал самоуправляется коллегией: @sergey486 и @emacsway . Бот для вступления в авторский коллектив: @ru_arc_bot

Предложить доклад для митапа: @ru_arc_meetup_bot

Группы:
@ru_arc_chat
@rasa_business
@archicases

Рекламу не размещаем.
Download Telegram
Chat Digest

💬 Огненное видео от Майкла Нигорда:
- https://t.me/ru_arc_chat/1072

💬 Ряд мега-полезных файлов по архитектурной таксономии:
- https://t.me/ru_arc_chat/1062

💬 Атрибуты качества и их влияние на выбор архитектурного подхода к ядру системы:
- https://t.me/ru_arc_chat/998

💬 Architecture Characteristics Worksheet:
- https://t.me/ru_arc_chat/1005

💬 Матрица решений по выбору типа базы данных:
- https://t.me/ru_arc_chat/1052

💬 Архитектура = структуры + текстуры. Качество кода - это одна из текстур:
https://t.me/ru_arc_chat/972

💬 Про асинхронные и синхронные стили коммуникации:
- https://t.me/ru_arc_chat/956
- https://t.me/ru_arc_chat/935
- https://t.me/ru_arc_chat/896

💬 Чем отличается простой микросервис от BC?
https://t.me/ru_arc_chat/832

💬 Стратегические паттерны DDD:
- https://t.me/ru_arc_chat/813
- https://t.me/ru_arc_chat/821

💬 Чем отличается Бизнес-процесс от Workflow?
- https://t.me/ru_arc_chat/757

💬 Как легче всего думать о Бизнес-логике?
- https://t.me/ru_arc_chat/737

💬 С чего начинается EventStorming?
- https://t.me/ru_arc_chat/734

💬 Есть ли альтернатива для синхронных доменных событий в FP?
- https://t.me/ru_arc_chat/710

💬 Microservices and the First Law of Distributed Objects:
- https://t.me/ru_arc_chat/701

💬 Distributed transaction patterns for microservices compared:
- https://t.me/ru_arc_chat/691

💬 Ищут ли люди в споре истину?
- https://t.me/ru_arc_chat/651

💬 Какую проблему решают агрегаты и почему они возникли?
- https://t.me/ru_arc_chat/646

💬 Помогает ли EventStorming предотвратить ошибки при моделировании агрегатов?
- https://t.me/ru_arc_chat/636

💬 Если человек прав, то почему к нему не всегда прислушиваются?
- https://t.me/ru_arc_chat/628

💬 Какая роль микросервисов в топологии команд?
- https://t.me/ru_arc_chat/466

💬 Откуда легче всего начинать искать терминологию по Software Engineering:
- https://t.me/ru_arc_chat/441

💬 Как разрабатываются стандарты?
- https://t.me/ru_arc_chat/412

💬 Чем отличаются Architecture, Design и Implementation?
- https://t.me/ru_arc_chat/361

💬 Считает ли Robert C. Martin микросервисы архитектурой и все ли с ним согласны?
- https://t.me/ru_arc_chat/352

💬 О собеседованиях по System Design:
- https://t.me/ru_arc_chat/329

💬 Что не так с названием SRP, и почему он зачастую работает наоборот?
- https://t.me/ru_arc_chat/312

💬 Не могу заплатить за книгу. Что делать?
- https://t.me/ru_arc_chat/295

💬 Архитектурная ката победителей O'Reilly:
- https://t.me/ru_arc_chat/273

💬 О метамоделях:
- https://t.me/ru_arc_chat/270

💬 Что читать по DDD?
- https://t.me/ru_arc_chat/268

💬 Каталоги и матрицы устарели и не соответствуют вызовам времени. Что применить взамен?
- https://t.me/ru_arc_chat/250

💬 Метамодель GoF:
- https://t.me/ru_arc_chat/246

💬 Шаблоны стабильности от Майкла Нигорда:
- https://t.me/ru_arc_chat/241

💬 Читать ли синюю книгу от Эванса? Не устарела ли она?
- https://t.me/ru_arc_chat/235

💬 Мега-статья о жертвенной архитектуре:
- https://t.me/ru_arc_chat/161

💬 Почему не все проекты успешны?
- https://t.me/ru_arc_chat/160

💬 Эффект новизны Хотторна от изучения новых технологий:
- https://t.me/ru_arc_chat/159

#ChatDigest
🔥192🤯1
👀 Новое видео на канале!
Топ жести на собеседовании: https://youtu.be/KdmYL8TJEIA

Что делают большинство разработчиков, когда им нужно провести собеседование? Правильно, гуглят 100 вопросов на собеседование на ${любимый_язык}. А потом мы все жалуемся, что на собеседованиях творится какая-то вакханалия.

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

🙏 Не забудьте поставить лайк и подписаться на YouTube канал, если видео вам понравилось!
👍7👎3🔥1
Russian Association of Software Architects
С чего начинается качественный код? Как говорил профессор Преображенский, разруха начинается с головы. И он был прав. Вернее, с «Закона Миллера»: 💬 «Магическое число семь плюс-минус два» («кошелёк Миллера», «закон Миллера») — закономерность, обнаруженная…
Проще всего пояснить "Закон магического числа 7 ± 2" этой картинкой☝️(кликните для увеличения). Как говорится, лучше один раз увидеть. Такой же процесс происходит, когда уровень сложности рассматриваемого фрагмента кода превышает возможности краткосрочной памяти человека.

Просто ваши глаза не могут увидеть все 12 точек одновременно. Ninio's extinction illusion. Twelve black dots cannot be seen at once. Ninio, J. and Stevens, K. A. (2000) Variations on the Hermann grid: an extinction illusion. Perception, 29, 1209-1217.

#SoftwareDesign
🔥17👍8🤔1
Какую же задачу решает качественный код?

💬 "Nothing kills speed more effectively than poor internal quality."
—"Planning Extreme Programming" by Kent Beck, Martin Fowler

💬 "... the activity of design is not an option. It must be given serious thought for software development to be effective."
—"Extreme Programming Explained" by Kent Beck

💬 "The only way to make the deadline — the only way to go fastis to keep the code as clean as possible at all times."
—"Clean Code: A Handbook of Agile Software Craftsmanship" by Robert C. Martin

💬 "In most contexts higher quality ⇒ expensive. But high internal quality of software allows us to develop features faster and cheaper."
—"Tradable Quality Hypothesis" by Martin Fowler

💬 "The value of good software design is economic: you can continue to add new functionality quickly even as the code-base grows in size."
—"Design Stamina Hypothesis" by Martin Fowler

💬 "The fundamental role of internal quality is that it lowers the cost of future change. But there is some extra effort required to write good software, which does impose some cost in the short term."
—"Is High Quality Software Worth the Cost?" by Martin Fowler

💬 "The whole point of good design and clean code is to make you go faster - if it didn't people like Uncle Bob, Kent Beck, and Ward Cunningham wouldn't be spending time talking about it."
—"Technical Debt Quadrant" by Martin Fowler

💬 "If you're a manager or customer how can you tell if the software is well designed? It matters to you because poorly designed software will be more expensive to modify in the future."
—"Is Design Dead?" by Martin Fowler

Сама по себе скорость разработки - это еще не цель. Это только задача в достижении цели.

Да, темпы разработки имеют имеют очевидные цели, такие как:
- экономический эффект за счет удешевления разработки,
- уменьшение ущерба упущенной выгоды от задержки выхода на рынок (time-to-market) новых бизнес-фич,
- повышение конкурентоспособности за счет ускорения адаптируемости к скороточно меняющимся условиям рынка...

Но есть еще одна цель, часто упускаемая из виду, та самая, которая имеет фундаментальное значение для анализа и архитектуры. И непонимание этой цели часто приводит к тому, что либо качество кода жертвуется в угоду краткосрочным бизнес-интересам, либо наоборот, качество делается ради качества где надо и не надо, выстраивая тем самым против себя глухую стену непонимания и обороны со стороны представителей бизнеса. Но об этом уже в другой раз.

#SoftwareDesign
👍7🔥3🤔1
Russian Association of Software Architects
О том же самом от редкого Мастера слова - Kent Beck: 📝 "Сделайте изменение легким, а потом делай легко изменение. Make the change easy then make the easy change." —Kent Beck, "Continued Learning: The Beauty of Maintenance - Kent Beck - DDD Europe 2020"…
Сегодня Big Design Up Front (BDUF) даже в проектах средней величины практически не применяется. Обрабатывать неопределенность заблаговременно (Prediction), путем логического вывода - это очень дорогая задача, стоимость которой может достигать экспоненциального роста по мере повышения точности прогнозирования (по крайней мере, по утверждению Robert C. Martin). В то время как бизнес-выгоды от этой точности возрастают куда скромнее, вплоть до логарифмического характера. Иными словами, нельзя повышать точность прогноза до бесконечности - у него есть предел экономической целесообразности.

Не знаю, лежит ли за такими выводами какая-то реальная статистика, но тот факт, что BDUF остался уделом небольших проектов, говорит о том, что они недалеко от истины.

💬 "To deal with the issues of incompletely known requirements and inaccurate estimates, a number of other types of models have been proposed: incremental, spiral, iterative, and evolutionary (adaptive)."
—"ISO/IEC/IEEE 12207:2017 Systems and software engineering - Software life cycle processes"

Тут мы подошли к той самой причине, по которой сегодня во всех крупных проектах применяются модели разработки, производные от итеративно-инкрементальной модели - они позволяют обрабатывать неопределенность эмпирически, т.е. опытным путем, вместо Prediction используя Adaptation. Выдвинули гипотезу, реализовали её в виде небольшого системного инкремента, проверили на практике, выявили отклонения и адаптировали систему - это и составляет основу итерации.

💬 "Therefore the most important function that software builders do for their clients is the iterative extraction and refinement of the product requirements...

I would go a step further and assert that it is really impossible for clients, even those working with software engineers, to specify completely, precisely, and correctly the exact requirements of a modern software product before having built and tried some versions of the product they are specifying.

Therefore one of the most promising of the current technological efforts, and one which attacks the essence, not the accidents, of the software problem, is the development of approaches and tools for rapid prototyping of systems as part of the iterative specification of requirements."

—"The Mythical Man-Month Essays on Software Engineering Anniversary Edition" by Frederick P. Brooks, Jr.
👍10🔥2
📆 29 июня 10:30 MSK
Решил продолжить в формате вебинаров. Послезавтра расскажу историю о том, как раньше проектирование помогало сбалансировать потребности и возможности заказчика и что случилось с этой деятельностью в наши дни.

Регистрироваться не надо. Просто подключайтесь по ссылке: https://youtu.be/4P5DLoaGPks
Russian Association of Software Architects
Сегодня Big Design Up Front (BDUF) даже в проектах средней величины практически не применяется. Обрабатывать неопределенность заблаговременно (Prediction), путем логического вывода - это очень дорогая задача, стоимость которой может достигать экспоненциального…
Каким же образом распространение эмпирического способа разрешения неопределенности отразилось на архитектуру?

Если раньше основным фокусом архитектуры считалось предвидение развития системы (Prediction):

💬 "Architecture is the decisions that you wish you could get right early in a project, but that you are not necessarily more likely to get them right than any other." — Ralph Johnson

То теперь её фокусом стала изменяемость (Adaptation), т.е. максимизация открытых решений, где их открытость определяется стоимостью их изменения:

💬 "A good architect pretends that the decision has not been made, and shapes the system such that those decisions can still be deferred or changed for as long as possible. A good architect maximizes the number of decisions not made."
—"Clean Architecture: A Craftsman's Guide to Software Structure and Design" by Robert C. Martin

Если вдруг кто не помнит - именно Robert C. Martin организовал Snowbird встречу 2001 года по Agile Manifesto.

Про смену фокуса говорится и в стандарте:

💬 "The incremental and iterative nature of Agile development can facilitate efficient technical and management processes and practices to reduce the cost associated with change. In comparison, projects managed at the waterfall end of the continuum seek to reduce total rework cost by minimizing the number of changes, limiting the number of control points, and baselining detailed specifications which are reviewed and traced throughout the project."
—"ISO/IEC/IEEE 12207:2017 Systems and software engineering - Software life cycle processes"

Забегая наперед, скажем, что не все так просто, и:

💬 "Agile Architecture shall seek a balance between intentional and emerging."
—"Open Agile Architecture" by The Open Group, Chapter "9.14. Axiom 14. Bias for Change"

#SoftwareArchitecture #Agile #SDLC
🔥4👍1
Russian Association of Software Architects
Каким же образом распространение эмпирического способа разрешения неопределенности отразилось на архитектуру? Если раньше основным фокусом архитектуры считалось предвидение развития системы (Prediction): 💬 "Architecture is the decisions that you wish you…
В предыдущем посте проскочил термин Agile. Да и в чате канала тоже этот термин не был обделен вниманием. Вероятно, теперь самое время разобраться с тем, что это такое. Удивительно, но будучи одним из самых обсуждаемых терминов, он остается одним из самых непонятных для многих.

💬 "Agile development - software development approach based on iterative development, frequent inspection and adaptation, and incremental deliveries, in which requirements and solutions evolve through collaboration in cross‐functional teams and through continual stakeholder feedback."
—"ISO/IEC/IEEE 12207:2017 Systems and software engineering - Software life cycle processes"

А вот, что говорит сам Jeff Sutherland - сооснователь Scrum:

💬 "Scrum is, as the reader supposedly knows, an agile method. The agile family of development methods evolved from the old and well-known iterative and incremental life-cycle approaches. They were born out of a belief that an approach more grounded in human reality – and the product development reality of learning, innovation, and change – would yield better results."
—"Jeff Sutherland's Scrum Handbook" by Jeff Sutherland

Agile модель разработки расширяет итеративно-инкрементальную модель и привносит в нее еще ряд психологически-философских принципов с целю устранения напряжения между представителями бизнеса и техническими специалистами. Но основное назначение остается прежним - разрешение неопределенности опытным путем (Adaptation):

💬 "No crystal balls. Humans are not able to predict the future. For example, your competition makes an announcement that was not expected. Unanticipated technical problems crop up that force a change in direction. Furthermore, people are particularly bad at planning uncertain things far into the future – guessing today how you will be spending your week eight months from now is something of a fantasy. It has been the downfall of many a carefully constructed Gantt chart."
—"Jeff Sutherland's Scrum Handbook" by Jeff Sutherland

Ладно, Jeff Sutherland - заинтересованное лицо. Он может быть субъективен, да и не все архитекторы его жалуют, а некоторые даже считают его угрозой для архитектуры. Послушаем лучше Gregor Hohpe:

💬 "Agile methods are most valuable when we're dealing with high levels of uncertainty."
—"Agile and Architecture: Friend, not Foe" by Gregor Hohpe

Ну и нельзя обойти в вопросе "Предвидеть" vs "Адаптировать" известную статью на эту тему:
"The New Methodology :: Predictive versus Adaptive" by Martin Fowler

#Agile #SDLC
🔥5👍4🤯2🤔1
Russian Association of Software Architects
В предыдущем посте проскочил термин Agile. Да и в чате канала тоже этот термин не был обделен вниманием. Вероятно, теперь самое время разобраться с тем, что это такое. Удивительно, но будучи одним из самых обсуждаемых терминов, он остается одним из самых непонятных…
Ладно, Robert C. Martin - лицо тоже заинтересованное. Все-таки Agile - его детище, и все его призывы к гибкой архитектуре можно списать на то, что ему нужно пропагандировать новое, отрицая старое. Да и в архитектурных кругах отношение к нему неоднозначное. А вот Grady Booch к нему на встречу Agile Manifesto в 2001-м не приехал, хотя был приглашен. Говорит, что был занят. Да и Len Bass в пропаганде Agile особо замечен не был. Посмотрим, что они говорят:

💬 "Grady Booch has also provided a set of guidelines for an agile architecture (which in turn imply some duties for the agile architect). Booch claims that all good software-intensive architectures are agile. What does he mean by this? He means that a successful architecture is resilient and loosely coupled. It is composed of a core set of well-reasoned design decisions but still contains some "wiggle room" that allows modifications to be made and refactorings to be done, without ruining the original structure.

Booch also notes that an effective agile process will allow the architecture to grow incrementally as the system is developed and matures. The key to success is to have decomposability, separation of concerns, and near-independence of the parts. (Sound familiar? These are all modifiability tactics.)

Finally, Booch notes that to be agile, the architecture should be visible and self-evident in the code; this means making the design patterns, cross-cutting concerns, and other important decisions obvious, well communicated, and defended. This may, in turn, require documentation. But whatever architectural decisions are made, the architect must make an effort to "socialize" the architecture."

—"Software Architecture in Practice" 3d edition by Len Bass, Paul Clements, Rick Kazman

P.S.: Кстати, этот график можно встретить у Len Bass в 3-м издании книги "Software Architecture in Practice" by Len Bass, Paul Clements, Rick Kazman, в главе "15 Architecture in Agile Project :: 15.1 How Much Architecture?".

Уже, правда, существует 4-е издание. Там в главе "24.3 Architecture and Agile Development" он приводит уже немного другие графики для понимания. Лично мне 3-е издание нравилось больше.

#SoftwareArchitecture #Agile
👍4🔥3
Russian Association of Software Architects
Ладно, Robert C. Martin - лицо тоже заинтересованное. Все-таки Agile - его детище, и все его призывы к гибкой архитектуре можно списать на то, что ему нужно пропагандировать новое, отрицая старое. Да и в архитектурных кругах отношение к нему неоднозначное.…
💬 "One trade-off that’s often overlooked is between the number of options you have and the resulting complexity. More options are desirable, but wanting to have all options all the time will result in unnecessary complexity, as is often the case with overly elaborate abstraction layers or massive configuration frameworks. I captured this effect into Gregor’s Law:
Excessive complexity is nature’s punishment for organizations that are unable to make decisions."

-- "Gregor's Law. Excessive complexity is nature’s punishment for organizations that are unable to make decisions" by Gregor Hohpe

💬 "If you pick any one aspect of software then you can make it easy to change, but we don’t know how to make everything easy to change. Making something easy to change makes the overall system a little more complex, and making everything easy to change makes the entire system very complex. Complexity is what makes software hard to change. That, and duplication."
-- Ralf Johnson at "Who Needs an Architect?" by Martin Fowler

Изменяемость тоже имеет свою стоимость. Нельзя создавать бесконечно гибкое решение. Важен баланс.

#SDLC #SoftwareArchitecture
🔥3👍1🤯1
Russian Association of Software Architects
💬 "One trade-off that’s often overlooked is between the number of options you have and the resulting complexity. More options are desirable, but wanting to have all options all the time will result in unnecessary complexity, as is often the case with overly…
FIGURE 3.6 Make decisions at the last responsible moment. The image source is "Essential Scrum: A Practical Guide to the Most Popular Agile Process" by Kenneth Rubin, "Chapter 3 Agile Principles :: Prediction and Adaptation".
👍2🔥2
Russian Association of Software Architects
FIGURE 3.6 Make decisions at the last responsible moment. The image source is "Essential Scrum: A Practical Guide to the Most Popular Agile Process" by Kenneth Rubin, "Chapter 3 Agile Principles :: Prediction and Adaptation".
💬 "Most of us would prefer to wait until we have more information so that we can make a more informed decision. When dealing with important or irreversible decisions, if we decide too early and are wrong, we will be on the exponential part of the cost-of-deciding curve in Figure 3.6. As we acquire a better understanding regarding the decision, the cost of deciding declines (the likelihood of making a bad decision declines because of increasing market or technical certainty). That's why we should wait until we have better information before committing to a decision."
—"Essential Scrum: A Practical Guide to the Most Popular Agile Process" by Kenneth Rubin, "Chapter 3 Agile Principles :: Prediction and Adaptation"

Более того, этот баланс Prediction/Adaptation зависит от конкретных условий проекта и исторического контекста. В конце 90-х снижалась стоимость адаптации, а системы были простыми. Сегодня средняя система на рынке стала на порядки сложней, стоимость адаптации диспропорционально возросла, но зато удешевляется Prediction, за счет появления Event Storming и других легковесных методик.

Стоимость Prediction не константна по отношению к жизненному циклу системы, и имеет тенденцию к понижению по мере реализации проекта.

Тот же Len Bass в вопросах поиска этого баланса ссылается на книгу "Balancing Agility and Discipline: A Guide for the Perplexed" by Barry Boehm, Richard Turner, которая вышла в свет через 2 года после Agile Manifesto.

Но это уже вопрос организации процессов разработки, в то время как этот месяц у нас посвящен (по результатам опроса) вопросам качества кода. Т.е. в данном контексте нас интересует не поиск оптимального баланса Prediction/Adaptation (хотя этот вопрос тоже важен, и можно продолжить его обсуждение в чате канала), а способ достижения экономической целесообразности Adaptation, как эмпирического способа разрешения неопределенности требований.

#Agile #SDLC
🔥4👍31
Chat Digest

💬 "Классическая статья Пэта Хэлланда "Data on the Outside vs. Data on the Inside"
- https://t.me/ru_arc_chat/1136

💬 "Mindmap по рискам и таксономии целей"
- https://t.me/ru_arc_chat/1147

💬 "Три опоры архитектора"
- https://t.me/ru_arc_chat/1168

💬 Что такое Система?
- https://t.me/ru_arc_chat/1194
- https://t.me/ru_arc_chat/1195

💬 ISO/IEC/IEEE 15288:2015 Systems and software engineering — System life cycle processes
- https://t.me/ru_arc_chat/1190

💬 Про умственное жонглирование на почве недостаточного качества кода:
- https://t.me/ru_arc_chat/1222

💬 Нельзя поддерживать бесконечную гибкость архитектуры - она тоже имеет свою цену:
- https://t.me/ru_arc_chat/1248

💬 Пара статей о балансе Prediction/Adaptation в SDLC-моделях:
- https://t.me/ru_arc_chat/1253
- https://t.me/ru_arc_chat/1254

💬 Причины отскока маятника от Adaptation к Prediction:
- https://t.me/ru_arc_chat/1263

💬 О гибридизации Agile и проектных практик:
- https://t.me/ru_arc_chat/1265

💬 Is Design Dead (for Agile)?
- https://t.me/ru_arc_chat/1272

💬 Два вида неопределенности требований:
- https://t.me/ru_arc_chat/1274

💬 CAP-theorem уже устарела. Что изучать?
- https://t.me/ru_arc_chat/1283

💬 О генерации кода микросервисов по диаграммам Event Storming:
- https://t.me/ru_arc_chat/1291

💬 Хорошее и простое руководство по Open Agile Architecture, которое отличается хорошим балансом лаконичности и информационной ценности, сопровождаемое демонстрационной моделью в Archi. Если не знаете с чего начать документирование архитектуры в Agile, то это самое оно:
- https://t.me/ru_arc_chat/1309

#ChatDigest
👍6🔥3
📆12 июля 10:30 MSK Новая YouTube-трансляция. В этот раз обсуждаем вопросы, связанные с модернизацией унаследованных приложений.

Задать вопросы, поделиться своим опытом и зарегистрироваться можно по ссылке: https://mxsmirnov.timepad.ru/event/2099600/
Russian Association of Software Architects
💬 "Most of us would prefer to wait until we have more information so that we can make a more informed decision. When dealing with important or irreversible decisions, if we decide too early and are wrong, we will be on the exponential part of the cost-of-deciding…
💬 "Кто-то спросит: так ли уж часто читается наш код? Разве большая часть времени не уходит на его написание?

Вам когда-нибудь доводилось воспроизводить запись сеанса редактирования? В 80-х и 90-х годах существовали редакторы, записывавшие все нажатия клавиш (например, Emacs). Вы могли проработать целый час, а потом воспроизвести весь сеанс, словно ускоренное кино. Когда я это делал, результаты оказывались просто потрясающими.

Большинство операций относилось к прокрутке и переходу к другим модулям!

- Боб открывает модуль.
- Он находит функцию, которую необходимо изменить.
- Задумывается о последствиях.
- Ой, теперь он переходит в начало модуля, чтобы проверить инициализацию переменной.
- Снова возвращается вниз и начинает вводить код.
- Стирает то, что только что ввел.
- Вводит заново.
- Еще раз стирает!
- Вводит половину чего-то другого, но стирает и это!
- Прокручивает модуль к другой функции, которая вызывает изменяемую функцию, чтобы посмотреть, как она вызывается.
- Возвращается обратно и восстанавливает только что стертый код.
- Задумывается.
- Снова стирает!
- Открывает другое окно и просматривает код субкласса. Переопределяется ли в нем эта функция?
<...>
В общем, вы поняли. На самом деле соотношение времени чтения и написания кода превышает 10:1. Мы постоянно читаем свой старый код, поскольку это необходимо для написания нового кода.

Из-за столь высокого соотношения наш код должен легко читаться, даже если это затрудняет его написание. Конечно, написать код, не прочитав его, невозможно, так что упрощение чтения в действительности упрощает и написание кода. Уйти от этой логики невозможно. Невозможно написать код без предварительного чтения окружающего кода. Код, который вы собираетесь написать сегодня, будет легко или тяжело писаться в зависимости от того, насколько легко или тяжело читается окружающий код. Если вы хотите быстро справиться со своей задачей, если вы хотите, чтобы ваш код было легко писать — позаботьтесь о том, чтобы он легко читался.

You might ask: How much is code really read? Doesn't most of the effort go into writing it?

Have you ever played back an edit session? In the 80s and 90s we had editors like Emacs that kept track of every keystroke. You could work for an hour and then play back your whole edit session like a high-speed movie. When I did this, the results were fascinating.

The vast majority of the playback was scrolling and navigating to other modules!

- Bob enters the module.
- He scrolls down to the function needing change.
- He pauses, considering his options.
- Oh, he's scrolling up to the top of the module to check the initialization of a variable.
- Now he scrolls back down and begins to type.
- Ooops, he's erasing what he typed!
- He types it again.
- He erases it again!
- He types half of something else but then erases that!
- He scrolls down to another function that calls the function he's changing to see how it is called.
- He scrolls back up and types the same code he just erased.
- He pauses.
- He erases that code again!
- He pops up another window and looks at a subclass. Is that function overridden?
<...>
You get the drift. Indeed, the ratio of time spent reading vs. writing is well over 10:1. We are constantly reading old code as part of the effort to write new code.

Because this ratio is so high, we want the reading of code to be easy, even if it makes the writing harder. Of course there's no way to write code without reading it, so making it easy to read actually makes it easier to write.

There is no escape from this logic. You cannot write code if you cannot read the surrounding code. The code you are trying to write today will be hard or easy to write depending on how hard or easy the surrounding code is to read. So if you want to go fast, if you want to get done quickly, if you want your code to be easy to write, make it easy to read."
—"Clean Code: A Handbook of Agile Software Craftsmanship" by Robert C. Martin, перевод: Е.Матвеев, ООО Издательство "Питер"

#SoftwareDesign
👍15
Russian Association of Software Architects
💬 "Most of us would prefer to wait until we have more information so that we can make a more informed decision. When dealing with important or irreversible decisions, if we decide too early and are wrong, we will be on the exponential part of the cost-of-deciding…
Можно добавить, что 10:1 - это еще оптимистическое соотношение для кода с приемлемым качеством.
Подведем итог: в процессе конструирования кода, 91% времени (в лучшем случае) занимает именно чтение кода и борьба со сложностью (каждым разработчиком регулярно), и только 9% времени (1:10) занимает ввод символов с клавиатуры (одним разработчиком единократно).

#SoftwareDesign
👍6
Сегодня в одном из чатов мне напомнили о том, что существует "Overengeneering", и это, в общем-то, как бы плохо. Отсюда напрашивается вывод, что, мол, не нужно развиваться, чтобы не стать оверинженерным и квазинаучным.

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

В индустрии это явление известно как "Синдром второй системы", который гласит, что вторая создаваемая система в практике специалиста обычно обладает переусложненностью.

По этому поводу хорошо выразился И.Е.Репин:

💬 "Сначала художник рисует плохо и просто.
Потом сложно и плохо.
Потом сложно и хорошо.
И только потом - просто и хорошо."


Ладно, И.Е.Репин - не IT-шник:

💬 "Simplicity is a great virtue but it requires hard work to achieve it and education to appreciate it. And to make matters worse: complexity sells better."
—Edsger W. Dijkstra, 1984 On the nature of Computing Science (EWD896)

Что можно в этом случае предпринять? Варианта два:

1. Уравновешивать когнитивные искажения технического специалиста, чем, собственно, и должна заниматься организация процессов разработки. По понятным причинам, сейчас мы в неё погружаться не будем. Главное - знать, что эта проблема решаема.

2. Чем большей полнотой знаний обладает специалист, тем большим моментом инерции обладает его устойчивость, тем меньшее воздействие на неё оказывает каждый новый инкремент знаний, и тем лучше достигается сбалансированность решений. Иными словами, лечится это увеличением охвата знаний. Нужно просто не зацикливаться и поскорее пройти этот этап профессионального становления.

Можно ли стать "переусложненным" постоянно развиваясь? Нет, не можно, и это хорошо видно на примере Kent Beck - невероятно эрудированного человека, обладающего редкой способностью объяснять сложные вещи простым языком. Объем списка использованной литературы его книг вызывает состояние легкого удивления, как и простота и ясность его формулировок. Другим таким ярким примером является @vladik_kh .

Объясняется это просто - возможности человеческого мозга ограничены, и, чтобы не потонуть в океане информации, и сохранить какую-то способность ориентироваться в ней, он начинает кристаллизировать её. Постоянно обобщая и систематизируя, он выводит наименее противоречивую форму этой информации. Количество переходит в качество.

Ну а самое главное - overengeneering является как раз следствием недостатка знаний о контексте и моменте своевременности применения тех или иных подходов. Излечить это незнание с помощью информационного голода технически невозможно, т.к. между YAGNI и Spaghetti-code имеется огромная разница, которая заключается именно в полноте знаний.

#SoftSkills #Simplicity
🔥6👍4👏1