Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-21 Thread Christian Schneider
Hi Dan, I don“t think that writing good architecture documentation is very expensive. The key is to leverage the knowledge that is already there and to describe only the most important things. But by asking you a lot the first point should be not so difficult :-) Christian Am 21.02.2011 18:

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-21 Thread Daniel Kulp
> "Architecture is the sum of the decisions about a project that are the > most expensive to change later. " The "decision" to not have up to date achitecture docs is one of the "decisions about a project that are the most expensive to change later". :-) Not saying it shouldn't be fixed, it'

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-20 Thread Christian Schneider
Hi Eric, yes this dicussion on the list is where the decisions are made. That works well and should not be changed. What I would like to add is a kind of summary that shows what the consensus was - of course with reference to the original discussion. The problem with only doing this on the lis

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-20 Thread Eric Johnson
For many of the major decisions this sort of discussion is done on the mailing list and archived. On Saturday, February 19, 2011, Christian Schneider wrote: > > > Am 19.02.2011 14:47, schrieb Glen Mazza: > > On 2/19/2011 8:24 AM, Christian Schneider wrote: > > > > The second thing I would like to

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-19 Thread Christian Schneider
Am 19.02.2011 14:47, schrieb Glen Mazza: On 2/19/2011 8:24 AM, Christian Schneider wrote: The second thing I would like to add is a page about architectural decisions. It should contain a short description of the process how we do these decisions and a list of decisions in a well defined for

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-19 Thread Glen Mazza
On 2/19/2011 8:24 AM, Christian Schneider wrote: The next thing is how to document our architecture. We have a good starting point at https://cwiki.apache.org/confluence/display/CXF20DOC/CXF+Architecture but I think some important things are lacking. This page describes the key structural eleme

Re: [Discuss] CXF Architecture and Architecture Documentation

2011-02-19 Thread Christian Schneider
Seems I overlooked the goals as they are almost at the bottom of the Architecture guide. So they are not missing :-) Christian Am 19.02.2011 13:31, schrieb Christian Schneider: Hi All, I know that the theme is a big one and likely will spawn some larger discussion still I think it is import

[Discuss] CXF Architecture and Architecture Documentation

2011-02-19 Thread Christian Schneider
Hi All, I know that the theme is a big one and likely will spawn some larger discussion still I think it is important to talk about it and to have a common understanding. When digging into some not so obvious issues I repeatedly stumble about the fact that there are important things about CXF