Chapter 011, Defining the System—Creating the Architecture and Documenting the Design

Each enterprise needs to adopt a partitioning model that reflects its own operating model. This chapter discusses the classification criteria that are generally applied to architectures and how these can be leveraged to partition the enterprise into a set of architectures with manageable complexity and effective governance.

• Software Documentation Types and Best Practices!
• The TOGAF Standard, Version - Architecture Partitioning.
• .
• Lunacy!
• SUN RAHA HAI NA TU PIANO SHEET MUSIC?

For the reasons outlined in the previous section, it is valuable to partition and organize the Enterprise Continuum into a set of related solutions and architectures with:. The following table shows how suitable classification criteria can be used to support partitioning of solutions:. Solutions are naturally organized into groups to support operational management and control.

Examples of solution partitions according to subject matter would include applications, departments, divisions, products, services, service centers, sites, etc. Solution decomposition by subject matter is typically the fundamental technique for structuring both solutions and the architectures that represent them. Solution lifecycles are typically organized around a timeline, which allows the impact of solution development, introduction, operation, and retirement to be managed against other business activity occurring in similar time periods.

The maturity and volatility of a solution will typically impact the speed of execution required for the solution lifecycle. Additionally, volatility and maturity will shape investment priorities.

Blog | Documenting Architecture Decisions | Relevance

Solutions existing in highly volatile environments may be better suited to rapid, agile development techniques. The following table shows how each classification criteria can be used to support partitioning of architectures:. The level of detail within an architecture has a strong correlation to the stakeholder groups that will be interested in the architecture.

Typically, less detailed architectures will be of interest to executive stakeholders. As architectures increase in detail, their relevance to implementation and operational personnel will also increase. In practical terms, architecture discipline is used to support a number of different types of architecture that are used for different objectives. The classification criteria described above can be used in different ways to support the achievement of each objective.

The following characteristics are generally not used to partition an Architecture Landscape:. The key objective of the Preliminary Phase is to establish the Architecture Capability for the enterprise. In practical terms this activity will require the establishment of a number of architecture partitions, providing defined boundaries, governance, and ownership. Generally speaking, each team carrying out architecture activity within the enterprise will own one or more architecture partitions and will execute the ADM to define, govern, and realize their architectures.

Types of documentation

If more than one team is expected to work on a single architecture, this can become problematic, as the precise responsibilities of each team are difficult to establish. For this reason, it is preferable to apply partitioning to the architecture until each architecture has one owning team. Finally, it is worth considering the distinction between standing capabilities of the enterprise and temporary teams mobilized to support a particular change initiative.

It has to be possible to determine the approximate cost of construction on the basis of preliminary building design documentation. Preliminary building design documentation contains as an output the justification of the solution selected and, if the construction work includes utility systems and utility work, the alternative solution selected for building them. Preliminary building design documentation shall also include a description of the size and location of technology and equipment, restrictions arising from their use, principles of placement and dimensions of service lanes and transport corridors and other specific requirements.

Requirements for the construction work quality are set and the issues of the safe use of construction work are solved at the preliminary building design documentation stage. The specifications contain a separate chapter based on subsection 3 9 of the Building Act on solutions which ensure the accessibility to and usability of public building and construction works by persons with reduced mobility and by visually impaired and hearing impaired persons.

Requirements for building design documentation

The principal building design documentation presents architectural and technical solutions and all important technical requirements for building products, the construction work and parts thereof. The solutions presented have to be verified and mutually compatible.

Principal building design documentation contains the technical parameters of the building products used and equipment selected and the requirements set therefor. Principal building design documentation does not specify techniques of construction technology and key solutions of construction, architecture and construction technology. Principal building design documentation presents the principles of standard solutions of important components socle, eave, corners, jambs, etc.

Manufacturers and the names of their equipment and building products are not mentioned, as a rule. The architectural and technical solutions presented in operational building design documentation and all important technical requirements for building products, the construction work and parts thereof have to be verified and brought into mutual conformity. Operational building design documentation shall contain technical information and a description of the quality of construction work in the volume which makes it possible to specify the construction cost, perform building work and assemble and set up the equipment.

The drawings for operational building design documentation, their scales and format shall be as convenient as possible for use at construction sites as basic material for the performance of building work. If possible, any notes and additional requirements shall be presented in the drawings in such a manner that it would not be necessary to follow several drawings and the specifications at the same time.

The building products and equipment selected and their installation and setup shall be described in the drawings, tables or lists of products. Standard solutions which are adjusted to the specific situation shall be presented in operational building design documentation.

My RT allows for:

The solutions of the systems and civil engineering works presented and their locations have to match and be mutually compatible to prevent interfering in their building and functioning and to make it possible to maintain and repair them. Product drawings do not constitute building design documentation as defined in section 18 of the Building Act. If necessary, the customer may request preparation of a plan for organisation of building work from the contractor. A plan for organisation of building work does not constitute building design documentation as defined in section 18 of the Building Act.

If building work is expected to affect traffic on public roads, the traffic management during building work shall have to be described.

If building work is accompanied by road works as defined in the Roads Act, the contractor shall be guided by the Regulation of the Minister of Economic Affairs and Communications No. If necessary, a plan for organisation of building work shall include installation diagrammes, different concreting stages and formwork design documentation, locations and liftings of cranes, temporary supports, support of slopes during building work, temporary utility systems and utility networks, technological techniques, instructions for the safe performance of building works and other necessary instructions for the conduction of building works at the discretion of the person preparing the plan.

An object can be presented as a virtual model or a 3D model according to an agreement between the parties. An amendment shall be based on the proposals and justifications of the party interested in making the modification. Amendments shall be approved by the customer in a form reproducible in writing and, unless the person making the amendments has prepared preliminary building design documentation, also by the person who prepared preliminary building design documentation.

The person making the amendment shall ensure the compatibility of the amendment with construction work and with the building design documentation amended. An amendment shall be legible and understandable and unambiguous to a specialist of the field, linked to the original building design documentation and identifiable through the drawing, preparer and time of preparation of the building design documentation amended. An amendment shall be attached to the respective part of building design documentation.

An additional specification shall be prepared concerning an amendment to the building design documentation, presenting the reasons for making the amendment, justifications for and explanations to the new solution, and possible effects of implementation of the amendment, unless these have been presented in the drawing. Due to documents added as a result of amendments, the building design undertaking shall also add a list of effective drawings, which includes in addition to the original list of drawings also the drawings which have been added, replaced or become invalid, in order to provide an adequate overview of effective drawings.

Building design documentation shall be assessed regardless of the stage of the building design documentation presented, proceeding from the volume of the preliminary building design documentation. Building design documentation shall be presented on paper media in two originals or in digital form. If building design documentation is presented in digital form, it has to be viewable in common formats which can be handled without special paid software.

When applying for a building permit, the layout part presented shall contain drawings which show the location of the construction work and maintenance status of the plot of land, traffic pattern, plan of pavements and landscaping, vertical planning solutions, master plan of utility networks and utility work and other similar relevant and necessary information.

If appropriate, the drawings listed can be combined provided that it does not impair the legibility and clarity of drawings.