InfoQ

News

New Resources for the Software Architecture

Posted by Steven Robbins on Mar 20, 2008 07:54 AM

Community
Architecture
Topics
Enterprise Architecture
Tags
Business/IT Alignment ,
SOA Adoption ,
Documentation
Several new resources are available for the software architect. Simon Brown and Kevin Seal have made available a set of guidelines for creating software architecture documentation. Mike Kavis also put together a framework to help guide the architect in dealing with the change that new architecture can bring.

The purpose of Brown and Seal's Software Architecture Document Guidelines v0.1 is to provide:
1. An outline description of the software architecture, including major software components and their interactions.
2. A common understanding of the architectural principles used during design and implementation.
3. A description of the hardware and software platforms on which the system is built and deployed.
4. Explicit justification of how the architecture meets the non-functional requirements.
Each of the 15 sections of the document included a short description or examples of the content to be included in the section along with a checklist for the architect. The authors created the guidelines as part of a tutorial they delivered at QCon London 2008. The document is available in PDF form.

Mike Kavis said "Most articles that I have read discuss two critical elements: the technology and governance. Not enough people are talking about change management." He used John Kotter's 8 steps from "Winning at Change" to show how architects can deal with the change necessary for Enterprise Architecture or SOA initiatives. Mike's 8 steps applied to architecture projects are
1. Build strong business case
2. Secure executive sponsor and top level buy in
3. Create a Road Map
4. Communicate the Road Map
5. Empower Others to Act on the Road Map
6. Start small, deliver early and often (agile)
7. Expand, leverage reuse
8. Govern
Mike also gave some insight in building a strong business case by focusing on business processes.
We did not talk about SOA in technical terms. What we did tell them is that by leveraging a "new" technology, we could automate their entire workflow from contract to delivery without having to rewrite any of our backend systems. This new technology would allow us to connect their new web based systems to the existing systems through an "adapter". Of course, by adapter I mean services.
By going through the business need for BPM, Mike's organization was able to get the business to champion the SOA and BPM initiatives.

2 comments

Reply

404 by JS Bournival Posted Mar 21, 2008 2:35 PM
Re: 404 by Steven Robbins Posted Mar 31, 2008 9:05 AM
  1. Back to top

    404

    Mar 21, 2008 2:35 PM by JS Bournival

    The «Mike also gave some insight» link isn't working.

  2. Back to top

    Re: 404

    Mar 31, 2008 9:05 AM by Steven Robbins

    Link is fixed. Thanks for the notice.


    Steve

Exclusive Content

Diary of a Fence Sitting SOA Geek

In this presentation, Mark Little explains the history of SOAP/WSDL/WS-*-based web services and RESTful HTTP and highlights how the two approaches might converge into a single solution.

Flex for XML and JSON

Platforms need interoperability. In this article Flex interoperability with JSON and XML is explored including direct mapping to chart and grid components.

Measuring Agile in the Enterprise: 5 Success Factors for Large-Scale Agile Adoption

Michael Mah analyzes the development process in 5 companies: 2 Agile (one of them BMC) and 3 classic. He presents the factors which contributed to the success of BMC's Agile adoption.

Tom Preston-Werner on Powerset, GitHub, Ruby and Erlang

In this interview filmed at RubyFringe 2008, Tom Preston-Werner talks about how both Powerset and GitHub use Ruby and Erlang, as well as tools like Fuzed, god, and more.

David Laribee on Alt.NET and its Mission

David Laribee discusses the purpose of ALT.NET, its mission and future.

Discover RailsKits and Stop Writing Redundant Code

Ruby on Rails has become a popular Ruby framework for creating web applications in recent years. An aspect of creating a web application is the need to repeatedly create the same base functionality.

A Formal Performance Tuning Methodology: Wait-Based Tuning

Steven Haines talks about tackling web application performance tuning by proposing a method called wait-based tuning.

Shaw and Fowler About Forging a New Alliance

Shaw and Fowler talk about the need for a new relationship between the business department and the IT department. Studies have shown that projects mostly fail due to miscommunication between the two.