Software Engineering Institute Carnegie Mellon

Course Offerings
Prices
Locations, Travel, and Lodging
Courses FAQ
Privacy Information (FERPA)
Registration
Contact Information
Credentials Program
SEI Certification

Documenting Software Architectures

Dates

2008* Prices (USD)

2008 Dates
January 17-18, 2008 (SEI Pittsburgh, PA)
May 14-15, 2008 (SEI Pittsburgh, PA)
September 25-26, 2008 (SEI Pittsburgh, PA)

Course Registration
Software Engineering Institute
Carnegie Mellon University
Pittsburgh, PA 15213-3890
Phone: 412 / 268-7388
FAX: 412 / 268-7401
Questions: courseregistration@sei.cmu.edu

To Register: Click Here

This course may also be offered by arrangement at customer sites. E-mail course-info@sei.cmu.edu or call +1 412-268-7622 for details.

*Course dates and fees are subject to change.

U.S.
Course Fee:
Industry: $1320
Government: $1055
Academic: $1055

International
Course Fee:
$1980


   Register for
2008 Dates

Course Description

 

Software architecture has become a widely accepted conceptual basis for the development of nontrivial software in all application areas and by organizations of all sizes. However, the treatment of architecture to date has largely concentrated on its design and, to a lesser extent, its validation. Effectively documenting an architecture is as important as crafting it; if the architecture is not understood (or worse, misunderstood), it cannot be analyzed effectively or meet its goal as the unifying vision for system and software development. Documentation-based architecture strategies stop short of prescribing documentation standards.

  • How do you document architectures using well-known styles such as service-oriented, client-server, multi-tiered, layered, and so forth?
  • What are effective architecture documentation guidelines?
  • How do you represent architectural elements and the relations among them?
  • How do you document interface semantics and architectural rationale?
  • How do you provide relevant architectural information to important stakeholders?
  • Are there templates for architecture documentation?

This two-day course provides in-depth coverage of effective software architecture documentation practices that meet the needs of the entire architecture stakeholder community. This course presents the information in the context of prevailing prescriptive models, including the Rational Unified Process (RUP), the Siemens Four Views software approach, the IEEE 1471-2000 standard, and the Unified Modeling Language (UML). The course is based on the book Documenting Software Architectures: Views and Beyond.

Audience   ·    Prerequisites    ·    Objectives   ·    Logistics

 

AUDIENCE
This course is targeted at

  • software architects and software lead designers whose jobs include producing architectural documentation
  • software technical managers whose jobs include overseeing and/or managing the architecture definition process
  • software engineers who may be expected to use architecture documentation

PREREQUISITES
Before registering for this course, participants must

  • have experience in designing and developing software-intensive systems
  • understand the basic concepts of software architecture. If desired, they can gain this understanding by completing the SEI Software Architecture: Principles and Practices course.

TOPICS

  • principles of sound documentation
  • viewtypes, styles, and views
  • advanced concepts such as refinement, context diagrams, variability, software interfaces, and how to document interfaces
  • documenting the behavior of software elements and software systems
  • choosing relevant views
  • building a documentation package using a seven-part template

OBJECTIVES
This course shows software architects how to produce a comprehensive documentation package for a software architecture that is useful to stakeholders. After attending this course, participants will have a better understanding of

  • the basic principles of sound technical documentation
  • a stakeholder- and view-based approach to documenting software architectures
  • which views are available for documenting an architecture
  • how to choose the set of views that will be most valuable to the architecture's community of stakeholders
  • the information needed to document a view
  • how to use formal and informal notations (including UML) to represent elements and relations in a view
  • how to document a software interface and software behavior
  • the information needed to document information that applies across views

Course Materials
Participants receive a copy of the lecture slides, exercises, and the book Documenting Software Architectures: Views and Beyond.

LOGISTICS

Class Schedule
This 2-day course meets at the following times:
Days 1-2, 8:30 a.m. - 5:00 p.m. (U.S. locations)
Days 1-2, 9:00 a.m. - 5:30 p.m. (non-U.S. locations)

Hotel and Travel Information
Information about traveling to the SEI offices is available on our Travel and Lodging Web pages.

Questions about this course?
Please see our Frequently Asked Questions Web page for answers to some of the more common inquiries about SEI Education and Training.

If you need more information, contact us via e-mail at course-info@sei.cmu.edu or telephone at +1 412-268-7622.



 

 

Related Products and Services

 

Courses
Software Architecture: Principles and Practices
Software Architecture Design and Analysis
Software Product Lines
ATAM Evaluator Training
ATAM Leader Training

Publications
Clements, P.; Bachmann, F.; Bass, L.; Garlan, D.; Ivers, J.; Little, R.; Nord, R.; & Stafford, J. Documenting Software Architectures: Views and Beyond. Boston, MA: Addison-Wesley, 2002.

Clements, P.; Kazman, R.; & Klein, M. Evaluating Software Architectures: Methods and Case Studies. Boston, MA: Addison-Wesley, 2002.

Bass, L.; Clements, P.; & Kazman, R. Software Architecture in Practice, 2nd Edition. Boston, MA: Addison-Wesley, 2003.

Services
Software Architecture Documentation Coaching
Architecture Evaluations
Architecture Reconstruction

Certificate Programs
Software Architecture Professional Certificate Program
ATAM Evaluator Certificate Program
ATAM Lead Evaluator Certificate Program

Methods
Views and Beyond Documentation Quality Attribute Workshop (QAW)
Architecture Tradeoff Analysis Method (ATAM)

Course Registration

 

  Register for 2008 Dates
 

^
TOP