SC 07 - How to Document the Architecture of Your Application Using UML and More

Paulo Merson, Software Engineering Institute (SEI), EUA

Friday, October 1, 2010 (08:30-12:00)

Abstract:

Have you ever been confused by an arrow in a box-and-line design diagram? Do you use UML in your software architecture? Have you ever wondered where is the line between architecture and detailed design? If your answer is yes to any of these questions, this mini-course has practical and valuable information for you. The goal is to show you what information about an architecture should be captured, so that others can successfully use it, maintain it, and build a system from it. Important takeaways from this mini-course include: architecture consists of multiple views; how can we use UML in each view and when other notations work better; what views can we use to evaluate performance, availability, modifiability and other qualities; how to complement structural diagrams with sequence diagrams, statecharts and alike; how to document software interfaces; guidelines and templates to make your architecture documentation more effective.

Lecturer:

• Paulo Merson has 20 years of software development experience. He currently works at the Software Engineering Institute (SEI) with software architecture, SOA, aspect-oriented software development, and component-based development. One of his assignments at the SEI is to teach a two-day course in "Documenting Software Architectures" for industry and government practitioners. Paulo also works in industry as a software architect. His recent speaking experience includes tutorials at SD Best Practices, Dr. Dobb’s Architecture & Design World, JavaOne, SEI SATURN, SBES and SBCARS, lectures to graduate students in different universities and invited talks at different companies. Prior to joining the SEI, he was a J2EE consultant and worked in the implementation of several enterprise applications. He is co-author of Documenting Software Architectures: Views and Beyond, 2nd edition. Paulo holds a Bs in Computer Science from University of Brasilia, and a Master of Software Engineering from Carnegie Mellon University.