RE: [architecture] Documentation Standard Requirements

[Luis Mourão <luis.mourao@xxxxxxx>]

Hi everybody,

 

As a newcomer I have been listening/reading on the sidelines quietly, but I think that Claus Hirth made a statement in his e-mail of fundamental importance, that should not be neglected.

 

Requirements, i.e. what is the criteria against which an existing solution is to be measured against is a pre-condition for objectively and rationally determining which one is the best suited. Do the suggested formats supported by DocBook and OpenOffice fulfill the requirements? To what extent? How do we weight the individual requirements, what are the risks, limitations, opportunities, in one and the other? Would a super or sub-set of the format be the most appropriate?

 

With the requirements in hand I would really suggest going through the exercise of doing some high level functional design, to get an idea of what eventual implementations will take, for example the labor cost, technological challenges, performance, scalability, extendibility, maintainability, modularity, deployability, testability, and my favorite simple elegant design and code!

 

I therefore would like to support Claus's call for requirements as the basis for the decision that we are being asked to help make.

 

I hope this help + regards to all,

--
Luis X. B. Mourão
e-mail: luis.mourao@xxxxxxx
phone: +45 2518 8117