blob: 788c5869560ee11cfa5e62a00468ccc90527afe6 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C/DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<!-- VERSION rmc:7.1.0 -->
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<!-- START NON-TRANSLATABLE -->
<title>openup&amp;#92;guidances&amp;#92;concepts&amp;#92;&amp;#92;core_principle_focus.xmi</title>
</head>
<!-- WARNING: do not modify the generated comments in this file below this line. They are used as markers for the import process. -->
<body>
Element Name: core_principle_focus.xmi<br/><br/>
<!-- END NON-TRANSLATABLE -->
<br/><br/><br/>
<!-- START NON-TRANSLATABLE -->
Attribute: presentationName<br/><br/>
<!-- END NON-TRANSLATABLE -->
<!-- START:presentationName,_9gocwMvoEdqukPpotm3DYg CRC: 3054414999 -->Focus on the architecture early to minimize risks and organize development<!-- END:presentationName,_9gocwMvoEdqukPpotm3DYg -->
<br/><br/><br/>
<!-- START NON-TRANSLATABLE -->
Attribute: briefDescription<br/><br/>
<!-- END NON-TRANSLATABLE -->
<!-- START:briefDescription,_9gocwMvoEdqukPpotm3DYg CRC: 2666352639 -->An evolving architecture helps the team to address complexity, drive risk mitigation, and organize development.<!-- END:briefDescription,_9gocwMvoEdqukPpotm3DYg -->
<br/><br/><br/>
<!-- START NON-TRANSLATABLE -->
Attribute: mainDescription<br/><br/>
<!-- END NON-TRANSLATABLE -->
<!-- START:mainDescription,-HTMJFV29MTZkKWqnIo01Gg CRC: 2923109487 --><h3>
Introduction
</h3>
<p>
The architecture of a software system is the organization or structure of the system's significant components
interacting through interfaces, with components composed of successively smaller components and interfaces.
</p>
<p>
Without an architectural foundation, a system will evolve in an inefficient and haphazard way. Such a system often
proves difficult to extend, reuse, or integrate without substantial rework. It is also difficult to organize the team,
or to communicate ideas without the <b>common technical focus</b> that the architecture provides.
</p>
<p>
Focus on the architecture early to minimize risks and organize development.
</p>
<h3>
Practices
</h3>
<h4>
Create the architecture for what you know today
</h4>
<p>
As Albert Einstein said, make everything as simple as possible, but no simpler. Software projects are
resource-constrained, and the desire of developers to create elegant solutions may lead to a system of greater
complexity than the stakeholder requires. Efforts to future-proof a system in a turbulent or uncertain environment will
likely lead to code bloat, which increases overall costs and complexity with few real benefits.
</p>
<p>
Create architectures that address the stakeholder’s real needs, and provide appropriate flexibility and speed for the
requirements as they are known today. Avoid the desire, no matter how well-intentioned, to speculate on future
requirements and thereby over-engineer the architecture. There is a distinction between over-architecting and building
an architecture that is flexible and extensible. For example, there may not be an apparent reason
for creating three architectural layers in a system, but it is probable that the system will grow in ways one
can't predict, so we should architect for that.
</p>
<h4>
Leverage the architecture as a collaborative tool
</h4>
<p>
Lack of a common understanding by developers about a system leads to indecision and contrary opinions among developers,
and can quickly paralyze the project. Developers may have different mental models of the system and work at cross
purposes to each other.
</p>
<p>
Create and evolve the system architecture with the intention of using it to align the developers' competing mental
models of the system. A good architecture facilitates collaboration by providing a common vocabulary for all
discussions regarding the system under development.
</p>
<h4>
Cope with complexity by raising the level of abstraction
</h4>
<p>
Software is complex, and people have a limited capacity for coping with complexity. As a system gets larger, it is
difficult for the team to develop a common understanding of the system, because it's hard to see the bigger
picture.
</p>
<p>
Use models to raise the level of abstraction to focus on important high-level decisions, such as relationships and
patterns, rather than getting bogged down in details. Modeling raises the level of abstraction, and allows the system to
be more easily understood from different perspectives.
</p>
<h4>
Organize the architecture into loosely coupled, highly cohesive components
</h4>
<p>
Tight coupling between components makes a system fragile and difficult to understand. Software is expensive to create,
so if existing components can be reused, that may reduce effort required to create a system.
</p>
<p>
Organize the architecture of the system into components to maximize cohesion and minimize coupling. This improves
comprehension, and increases flexibility and opportunities for re-use.
</p>
<h4>
Reuse existing assets
</h4>
<p>
It is wasteful to build what you can simply reuse, download, or even buy.
</p>
<p>
Make every effort to reuse existing assets. Developers are often reluctant to reuse assets, because those assets do not
exactly meet their needs, or those assets are of poor quality. Be prepared to balance the savings you can realize using
an existing asset, even if the asset requires you to make some accommodation in the architecture or relax a constraint.
</p><!-- END:mainDescription,-HTMJFV29MTZkKWqnIo01Gg -->
</body>
</html>