Hi, Henning...
You are right.. the structure definition IS for the moment. What I intended with my thoughts was to enlight that a "which" can bring a lot of responsabilities and side-effects in a middle/long shoot. The "example" topic is indeed very interesting and desired, but it brings/aggregates a lot of work, so just now, my concern is to first do the "must-have" things and after focus and the "which list".
Please, Iñaki, I not intended to make You give up from Your idea... far away from this interpretation... I just wanted to present my thoughts on the inherited/derived issues/problems and ask You for help...
Edson
-----Original Message----- From: Henning Westerholt [mailto:henning.westerholt@1und1.de] Sent: quarta-feira, 27 de fevereiro de 2008 10:22 To: openser-docs@lists.openser.org Cc: Edson; 'Iñaki Baz Castillo' Subject: Re: [OpenSER-Docs] Add examples in module documentation
On Wednesday 27 February 2008, Edson wrote:
[..] But and the "Examples"? Well if they are really desired, than we still
have
two sources: the DOC-guys and the community (through a WIKI?). But I
would
exclude the DOC-guys, since they are focused on the DOC structure and compilation. Sure that as a side-effect they will learn a lot about functionalities and tips and twiks... but will still be only DOC-guys. So we stand with the community... [..] Just before ending, I'd say that structure is not the biggest problem
right
now... it comes alone in the main structure discussion...
Hi Edson,
for the moment i care about the structure, to get the foundation right. After these are layed we should really care about the content, as you said, the structure is not our main problem.
I would like to add that i hope that this list will be mainly about the content. BTW, if anybody is not interested in this whole structure discussion, feel free to start right now in improving any existing documentation.
Cheers,
Henning