Mailing-List: contact dev-help@harmony.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@harmony.apache.org
Received-SPF: pass (herse.apache.org: local policy)
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Subject: RE: [general] upcoming snapshot (JDK this time)
Date: Thu, 30 Nov 2006 10:33:16 +0300
Message-ID: 
 <523F3D8D8C97554AA47E53DF1A05466A6D92BA@nnsmsx411.ccr.corp.intel.com>
Thread-Topic: [general] upcoming snapshot (JDK this time)
Thread-Index: AccUTVx2+mHGGMYTTXW4J5Yi8wfdTAAAszrA
From: "Morozova, Nadezhda" <nadezhda.morozova@intel.com>
To: <dev@harmony.apache.org>,
	<geir@pobox.com>

>The kind of docs that would be appropriate are the docs you get with
>Sun's JDK, and to be frank, I think that's one single README.html :)

We can have a similar starting-point webpage with an intro. I can write
such a page. Some website pages can be relevant as well. We can rewrite
the relevant parts in the starting page or include them in the snapshot
as they are. Suggested pages to be included with the build:
- Quickhelp_users.html - how to start using the snapshot, configure env.
etc
- Status.html and roadmap.html - info on what to expect from the
snapshot
- Faq.html - common questions on the project
- Documentation.html - links to all docs that we have

>I think a page of docs with links back to our "universe" would be cool,
>but I'm not sure what a user would get out of a full set of docs.  But
>that said, I don't see much real harm if it isn't too big...  how big
is
>it?
I guess the component docs weigh the most because they have graphics.
Classlib docs amount to 1.29Mb, drlvm docs to over 3Mb.

Cheers,=20
Nadya
=20

>-----Original Message-----
>From: Geir Magnusson Jr. [mailto:geir@pobox.com]
>Sent: Thursday, November 30, 2006 10:00 AM
>To: dev@harmony.apache.org
>Subject: Re: [general] upcoming snapshot (JDK this time)
>
>Well, I'll note  that there's no source in this - it's a binary build.
>
>The kind of docs that would be appropriate are the docs you get with
>Sun's JDK, and to be frank, I think that's one single README.html :)
>
>I think a page of docs with links back to our "universe" would be cool,
>but I'm not sure what a user would get out of a full set of docs.  But
>that said, I don't see much real harm if it isn't too big...  how big
is
>it?
>
>geir
>
>
>Morozova, Nadezhda wrote:
>> I've thought of the site pages only, at least this time.
>> Pages like quick helps, component definitions (build-test framework,
>> classlib and drlvm), roadmap to name a few.
>> I'd think more and send a proposal - if this is in line with others'
>> opinions.
>>
>> Cheers,
>> Nadya
>>
>>
>>> -----Original Message-----
>>> From: Geir Magnusson Jr. [mailto:geir@pobox.com]
>>> Sent: Thursday, November 30, 2006 9:52 AM
>>> To: dev@harmony.apache.org
>>> Subject: Re: [general] upcoming snapshot (JDK this time)
>>>
>>> Docs are good.  What did you have in mind?
>>>
>>> This is a user oriented snapshot - to get people to test things, so
I'm
>>> not sure if things like our doxygen output is appropriate...
>>>
>>> geir
>>>
>>>
>>> Morozova, Nadezhda wrote:
>>>> Geir,
>>>> Do you think we shall include any docs with this snapshot? Or would
>> your
>>>> innovation with JDK be enough newness this time?
>>>> If you do plan to include some docs, I could do some thinking and
>> make a
>>>> proposal on which should go. Just say you need it and I'll have it
in
>> a
>>>> couple of hours :)
>>>>
>>>> Cheers,
>>>> Nadya
>>>>
>>>>
>>>>> -----Original Message-----
>>>>> From: Geir Magnusson Jr. [mailto:geir@pobox.com]
>>>>> Sent: Thursday, November 30, 2006 9:29 AM
>>>>> To: dev@harmony.apache.org
>>>>> Subject: [general] upcoming snapshot (JDK this time)
>>>>>
>>>>> I forsee that tomorrow or friday I'll have enough done in jdktools
>> so
>>>> we
>>>>> can do our first JDK snapshot.
>>>>>
>>>>> It should have javac and java at the minimum and a real jdk-like
>>>> layout.
>>>>> Are there any concerns or holds in classlib or drlvm right now?
>>>>>
>>>>> It's high time we do another, and would be cool to make the switch
>> and
>>>>> add the JDK
>>>>>
>>>>> geir