Why Decision Log is important for an Architect?

As an Architect during the life cycle of Product Development, key decisions will be made for some valid reasons. Often if these reasons are not documented in a Decision Log then down the lane it will be hard for anyone to understand why certain decisions are made at that time.

I personally get challenged asking these type of questions typically when people leave the project and new people take the role and they would like to understand why certain decisions have been made and rationale behind them. 

Having a Decision Log and documenting the rationale will be really handy in these situations. As Simon Brown mentioned in his "Software Architecture for Developers" book keep them simple as it is mainly for technical audience.

Comments

Post a Comment

Popular posts from this blog

Architecture diagram using Visio Stencils

Image
In the previous post, I emphasised on how much a picture can communicate than words. In order to draw good Architecture diagrams using Visio, first we need the proper stencils. The following stencils would be handy for any Architecture diagrams using Visio. Office Stencils Microsoft Azure, Cloud and Enterprise Symbol / Icon Set Azure Reference Architectures Microsoft Integration Stencil Pack Exchange 2013 Stencil SOA Stencils (from Arcitura) ( Symbol Legend ) Cloud Computing Stencils (from Arcitura) ( Symbol Legend )
Read more

The Death of the Architect

I just received an email with this subject line and got curious and started reading it immediately. ( https://dzone.com/articles/the-death-of-architecture?edition=347143 ) Though I agree with some of the points in the article but I don't agree the fact that Architect role is disappearing. With Cloud computing, I personally feel the responsibilities of an Architect has increased. There are far too many options and ways of addressing the problem using Cloud Solutions and that's when you need a Pragmatic Architect. I completely accept the fact that we don't need Ivory Tower Architects and we need Architects who definitely knows writing code and be part of the Development team ( https://www.infoq.com/articles/architects-should-code-bryson/ ). The Architect must know when to assist the Development Team with coding activities and when to focus on Architecture activities. Pragmatic Architect knows how to balance this quite well and they earn respect from the Development Teams.
Read more

Communication skills for an Architect

Communication Skill is a key skill for a Software Architect. An Architect need to communicate to different set of audiences starting from C-level Executives, Business Stakeholders, Subject Matter Experts to Software Developers. They have to communicate the solutions in different ways to different audiences. Normally this takes time and comes by practice and experience. The Architect must also be capable of communicating their points with clarity so it is easy to understand for the rest. There is no point in writing pages and pages of architecture documents instead how it can be communicated to the team is really the value added. "A picture is worth a thousand words". Therefore try and communicate your ideas in diagrams. These diagrams can be in Visio or even a white board drawing as long as it can convey the message.
Read more