harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Ivanov, Alexey A" <alexey.a.iva...@intel.com>
Subject RE: [doc]proposal to improve and expand website
Date Thu, 03 Aug 2006 07:25:22 GMT
Nadezhda,

>-----Original Message-----
>From: Morozova, Nadezhda [mailto:nadezhda.morozova@intel.com]
>Sent: Wednesday, August 02, 2006 8:52 PM
>To: harmony-dev@incubator.apache.org; geir@pobox.com
>Subject: RE: [doc]proposal to improve and expand website
>
>Geir,
>Let me double-check what exactly you are proposing:
>
>> I wonder if it's time we pull that stuff out of classlib/ and move to
>> the site itself...
>
>Do you mean that we do the following:
>1) Move the ASN1 and REGEXP docs out of docs/externals to
>xdocs/subcomponents/classlib by converting them to XML?

What kind of XML do you mean? I just can't understand.

>2) Move the html docs packaged with classlib donations (JNDI DNS, AWT,
>JAVA2D) to the same directory with conversion involved?
>
>I'd also recommend that we do the same for stable VM docs, like
DevGuide
>and Getting Started.
>
>Now, the idea of integrating the docs into the site is just fine with
>me.
>
>However, the docs are very HTML-driven now, so you can't just cut&paste
>the HTML content with a couple of manual replacements and have a valid
>XML. There're over 15 styles that cannot map to standard XML tags.
We'll

What are standard XML tags? Or do you mean XHTML?
Or am I just missing anything?


Thank you in advance,
Alexey.

>have to think of some content model and a DTD for those, probably. And
>still this will mean a lot of work.
>So I was wondering whether it is worth the effort? What will the major
>benefits of conversion be? Couldn't we just have the docs statically in
>HTML? At least for now?
>
>Best regards,
>Nadya Morozova,
>
>-----Original Message-----
>From: Geir Magnusson Jr [mailto:geir@pobox.com]
>Sent: Wednesday, August 02, 2006 6:32 PM
>To: harmony-dev@incubator.apache.org
>Subject: Re: [doc]proposal to improve and expand website
>
>
>
>Morozova, Nadezhda wrote:
>
>> I scanned the svn repository for classlib packages, and found a few
>more
>> that had docs with them, namely the JNDI DNS Service Provider, the
AWT
>> framework and the Java2D implementation. I could move their docs to
>the
>> externals/ directory as well.
>> Now, this makes multiple docs in one folder, so I thought I'd group
>all
>> classlib package docs into a classlib/ subfolder and all DRLVM docs
>into
>> the drlvm/ subfolder. Shared files, like the style sheet, could be
>> placed in those folders to avoid duplication.
>
>I wonder if it's time we pull that stuff out of classlib/ and move to
>the site itself...
>
>geir
>
>
>---------------------------------------------------------------------
>Terms of use : http://incubator.apache.org/harmony/mailing.html
>To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
>For additional commands, e-mail: harmony-dev-help@incubator.apache.org
>
>---------------------------------------------------------------------
>Terms of use : http://incubator.apache.org/harmony/mailing.html
>To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
>For additional commands, e-mail: harmony-dev-help@incubator.apache.org

--
Alexey A. Ivanov
Intel Middleware Product Division

---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org


Mime
View raw message