karaf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andreas Pieber <anpie...@gmail.com>
Subject Re: Document archtiectural decisions in Wiki
Date Tue, 07 Feb 2012 12:20:59 GMT
As already stated on IRC I'm very much +1 for documenting those 
decisions. Will make various things much easier to adapt/correct 
afterwards. Though one thing I've found in you're template I do not 
really like is the "supporter/aginst" section. I think this does not 
really help anybody than to "pranger" someone if a decision does not 
work out as planed. I think we should rather add an involved section to 
make it easier finding out who was involved in a decision.

Otherwise rellly cool. Thxs for starting this.

Kind regards,

On Tue 07 Feb 2012 11:30:02 AM CET, Christian Schneider wrote:
> Hi all,
> I discussed with Andreas on IRC that it is would be good to document 
> architectural decisions in the wiki. The idea is to extract the most 
> important informations from discussions on e.g. the mailing list. The 
> list should allow us to point new developers to decisions that were 
> made so they can inform themselves about these before dicussing the 
> decisions. The list should also allow to revisit decisions from time 
> to time so we have the chance to change a decision if for example the 
> reasons for it change.
> See
> https://cwiki.apache.org/confluence/display/KARAF/Architectural+decisions
> I currently added a first decision for console as it came up on the 
> irc channel. Please document further decisions as you see fit and also 
> help making existing ones more concise.
> We should of course not document every little decision. I think a good 
> indicator that a decision should be documented is when it is discussed 
> often and or heated :-)
> Christian

View raw message