Session:Documentation--Positions

From WICSA Conference Wiki

moderator: Paul Clements

Abstract

Obtaining the appropriate architecture for a software system assures the long-term success of the product. Without a documentation a well defined architecture is very hard or impossible to analyze leaving you unable to evaluate the quality of the product and the change impact. Further, developers will be unable to produce an implementation that conforms to the architecture, nor will other stakeholders be able to rely on it in order to do their jobs: testers and maintainers, just to name two. Thus, architecture documentation emerges as a critically important practice that is part of the architect's duties.

This session will explore documentation issues in various contexts, including architecture conformance issues, practical documentation in a small organization, choosing the best views to satisfy stakeholders, documenting extracted architectures, and others.

Participants

Please add yourself to this list. Tell us something about your background. Add a few sentences about the working session topic such as your position, questions you would like to see discussed, etc.

1. Paul Clements.
2. Jonathan Aldrich. As an assistant professor at Carnegie Mellon University, my architecture-related research focuses on static techniques (such as the ArchJava language) for verifying conformance between architecture and implementation. My colleagues and I have a position paper on a technique for synchronizing an abstract architectural description with architectural information derived from code. In the working session, I am interested in discussing the tradeoffs among alternative ways of checking conformance between architecture and code.
3. Marwan Abi-Antoun (Scribe) I'm a Ph.D. student in Software Engineering at Carnegie Mellon University, advised by Professor Jonathan Aldrich. I'm interested in documenting the architectural intent directly in the code.
4. Rafael Capilla - Participant, Assoc. Prof. University Rey Juan Carlos, Madrid, Spain
5. Aline Vasconcelos - Participant, PHD Student at Federal University of Rio de Janeiro, Brazil, working with architecture recovery.
6. Bas Graaf - PhD. student at Delft University of Technology in the Netherlands. Currently I am working on techniques that enable to use existing software development products, such as architecture documentation, in migration trajectories. In particular I am looking at how a migration can be supported by automated techniques developed in the context of the MDA.
7. Paulo Merson
8. Gentzane Aldecoa - PhD. student at Mondragon University, Spain. My research focus is on architecture and software product lines.
9. Salvador Trujillo - Participant, Ph.D student, interested on Software Product Lines and Web Portals Development.
10. Nelis Boucke - PhD. student at KULeuven, Belgium. My research interested is in architecture and an architectural method for developing complex (large scale) distributed systems

Pre-registration for working sessions on the wiki is now closed. If you have not done so already, please sign up for working sessions at the conference registration table on Monday or Tuesday morning. We want to keep these sessions small to foster discussion. Seating is limited in some rooms. Because of this there may be a limit on the number who can participate - if that is the case then the first to sign up will be given preference. Once you have signed up at the registration table and ensured you have a spot, you can return here and add yourself to the list and introduce yourself.