Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and Addison-Wesley was aware of a trademark claim, the designations have been printed with initial capital letters or in all capitals.

CMM, CMMI, Capability Maturity Model, Capability Maturity Modeling, Carnegie Mellon, CERT, and CERT Coordination Center are registered in the U.S. Patent and Trademark Office by Carnegie Mellon University.

ATAM; Architecture Tradeoff Analysis Method; CMM Integration; COTS Usage-Risk Evaluation; CURE; EPIC; Evolutionary Process for Integrating COTS Based Systems; Framework for Software Product Line Practice; IDEAL; Interim Profile; OAR; OCTAVE; Operationally Critical Threat, Asset, and Vulnerability Evaluation; Options Analysis for Reengineering; Personal Software Process; PLTP; Product Line Technical Probe; PSP; SCAMPI; SCAMPI Lead Appraiser; SCAMPI Lead Assessor; SCE; SEI; SEPG; Team Software Process; and TSP are service marks of Carnegie Mellon University.

IEEE Std 1471 is a trademark of the Institute of Electrical and Electronics Engineers, Inc.

Special permission to reproduce portions of the following is granted by the Software Engineering Institute:

• Robert L. Nord, Paul C. Clements, David Emery, and Rich Hilliard, “A Structured Approach for Reviewing Architecture Documentation” (CMU/SEI-2009-TN-030). Copyright © 2009 by Carnegie Mellon University.

• Felix Bachmann, Len Bass, Paul Clements, David Garlan, James Ivers, Reed Little, Robert Nord, and Judith Stafford, “Documenting Software Architecture: Documenting Behavior” (CMU/SEI-2002-TN-001). Copyright © 2002 by Carnegie Mellon University.

• Felix Bachmann, Len Bass, Paul Clements, David Garlan, James Ivers, Reed Little, Robert Nord, and Judy Stafford, “Documenting Software Architectures: Organization of Documentation Package” (CMU/SEI-2001-TN-010). Copyright © 2001 by Carnegie Mellon University.

• Felix Bachmann, Len Bass, Jeromy Carriere, Paul Clements, David Garlan, James Ivers, Robert Nord, and Reed Little, “Software Architecture Documentation in Practice: Documenting Architectural Layers” (CMU/SEI-2000-SR-004). Copyright © 2000 by Carnegie Mellon University.

• Felix Bachmann, Len Bass, Paul Clements, David Garlan, James Ivers, Robert Nord, Reed Little, and Judith Stafford, “Software Architecture Documentation in Practice: Documenting Software Interfaces” (CMU/SEI-2002-TN-015). Copyright © 2002 by Carnegie Mellon University.

The authors and publisher have taken care in the preparation of this book, but make no expressed or implied warranty of any kind and assume no responsibility for errors or omissions. No liability is assumed for incidental or consequential damages in connection with or arising out of the use of the information or programs contained herein.

The publisher offers excellent discounts on this book when ordered in quantity for bulk purchases or special sales, which may include electronic versions and/or custom covers and content particular to your business, training goals, marketing focus, and branding interests. For more information, please contact:

U.S. Corporate and Government Sales
(800) 382-3419
[email protected]

For sales outside of the U.S., please contact:

International Sales
[email protected]

Visit us on the Web: informit.com/aw

Library of Congress Cataloging-in-Publication Data

Documenting software architectures : views and beyond / Paul Clements
... [et al.]. — 2nd ed.
            p.    cm.
    Includes bibliographical references and index.
    ISBN 978-0-321-55268-6 (hardcover : alk. paper)
  1.  Computer architecture. 2.  Software documentation.  I. Clements,
Paul, 1955– II. Title.
    QA76.9.A73D63 2010
    005.1’5—dc22
                                                                                                      2010024318

Copyright © 2011 Pearson Education, Inc.

All rights reserved. Printed in the United States of America. This publication is protected by copyright, and permission must be obtained from the publisher prior to any prohibited reproduction, storage in a retrieval system, or transmission in any form or by any means, electronic, mechanical, photocopying, recording, or likewise. For information regarding permissions, write to:

Pearson Education, Inc.
Rights and Contracts Department
501 Boylston Street, Suite 900
Boston, MA 02116
Fax: (617) 671-3447

ISBN-13: 978-0-321-55268-6
ISBN-10:        0-321-55268-7

Text printed in the United States on Recycled paper at Courier in Westford, Massachusetts.
First printing, October 2010