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(a)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