[OpenSER-Docs] Add examples in module documentation

[Edson]

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 at 1und1.de]
>Sent: quarta-feira, 27 de fevereiro de 2008 10:22
>To: openser-docs at 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