harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Morozova, Nadezhda" <nadezhda.moroz...@intel.com>
Subject RE: [doc]proposal to improve and expand website
Date Wed, 02 Aug 2006 16:52:16 GMT
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? 
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
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


Mime
View raw message