Mailing-List: contact user-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@geronimo.apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Message-ID: <44FC8AF4.4000205@ncode.ch>
Date: Mon, 04 Sep 2006 22:22:12 +0200
From: Oli Kessler <ok@ncode.ch>
Organization: ncode solutions gmbh
User-Agent: Mozilla Thunderbird 1.0.8-1.1.fc4 (X11/20060501)
MIME-Version: 1.0
To: user@geronimo.apache.org
Subject: Re: Geronimo v1.2 documentation
References: <44F32562.6070407@gmail.com> <6027430.post@talk.nabble.com>
 <44F35809.4020401@gmail.com>
In-Reply-To: <44F35809.4020401@gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-taridium.networks-MailScanner-Information: 
X-taridium.networks-MailScanner: Found to be clean
X-MailScanner-From: ok@ncode.ch
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Would be nice if the XML schema documentation is two-folded: The xsd
should have brief descriptions using xs:documentation tags which come in
 handy when using any xml editor that can show them as tooltipps/hovers
or on autocompletion - More detailed information should be put in the
wiki along with samples.

Things seen so far in the URL indicated look promising!

Cheers,
-ok

Hernan Cunico wrote:
> Thanks a lot for the feedback
> 
> Adding to the list:
> - config.xml
> - deployment plans
> 
> We are currently working on documenting the schemas for v1.1, well just
> starting ;-)
> 
> It would be great if we can get your feedback on these articles.
> 
> http://cwiki.apache.org/GMOxDOC11/geronimo-application-11xsd.html
> 
> Cheers!
> Hernan
> 
> raxpl wrote:
> 
>> a hyperlinked listing of config. xml tags (properties) and the possible
>> values and what they achieve...for things like geronimo-web.xml (ideally
>> kept up to date as a core bit of documentation)
>> - well this is asking for a lot but i work a lot on Adobe Flex and i got
>> that out of the box (but it's expensive so they can afford documentation
>> teams)
>> But that's the big challenge when you've got all the simple tutorial apps
>> etc. working...how do i get to grips with rest of the behemoth !
>>
>>
>> Hernan Cunico wrote:
>>
>>> Hi All,
>>> I would like to initiate a thread for discussing the topics to cover
>>> in the Geronimo v1.2 documentation.
>>>
>>> The idea is to build a prioritized list and then derive it into a TOC.
>>>
>>> What would you guys like to see in the Geronimo v1.2 doc?
>>>
>>> Cheers!
>>> Hernan
>>>
>>>
>>

-- 
ncode solutions gmbh
http://www.ncode.ch

tel +41 43 817 01 88
fax +41 43 817 02 88
Zurich / Switzerland