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: [jira] Commented: (HARMONY-2009) Brush up and update
 Eclipse-related docs, make them user-friendly.
Date: Wed, 29 Nov 2006 22:05:39 +0300
Message-ID: 
 <523F3D8D8C97554AA47E53DF1A05466A6D9233@nnsmsx411.ccr.corp.intel.com>
Thread-Topic: [jira] Commented: (HARMONY-2009) Brush up and update
 Eclipse-related docs, make them user-friendly.
Thread-Index: AccTqGQhNfzkzddARQiUHnPwpdWIEwAAKRKQAALIVtAADUtAQA==
From: "Morozova, Nadezhda" <nadezhda.morozova@intel.com>
To: <dev@harmony.apache.org>

An update would be most welcome :)=20

Cheers,=20
Nadya
=20
>-----Original Message-----
>From: Konovalova, Svetlana [mailto:svetlana.konovalova@intel.com]
>Sent: Wednesday, November 29, 2006 3:59 PM
>To: dev@harmony.apache.org
>Subject: RE: [jira] Commented: (HARMONY-2009) Brush up and update
Eclipse-
>related docs, make them user-friendly.
>
>Nadya, Sian,
>
>>I'm replying to your comments on the dev list rather than in the JIRA
>>itself
>>(HARMONY-2009) as this seemed like a discussion.  I have written
>>some responses inline, but I just wondered whether since there was no
>>response to the "Anybody tried DRLVM+Eclipse and can share?" thread if
>it
>>would be a good idea to remove the DRLVM section from that page.  I
>think
>>we
>>had discussed this before in a previous thread.  What do you think?
>>
>[Nadya] well, I think if we neglect eclipse+drlvm at all, nobody would
>ever try it. I suggest that we keep the distribution of general vs.
>classlib specific, and hold a placeholder for drlvm... and hope :)
>
>[SV]+1 for a placeholder. IMHO DRLVM shouldn't be forgotten.)
>
>>> - Introduction: 1st sentence is about harmony, 2nd - about classlib
>only.
>>> what about drlvm? an intro to the kind of info on drlvm development
>tips
>>> would be great.
>>
>>
>>I'm not sure how useful the DRLVM information is here (see above
>comments),
>>but if we do decide to keep it I agree that we should include an
>>introductory paragraph.
>[Nadya] ok, let's ask somebody else about it and see what they say.
>>
>>
>>- Prerequisites: (just curious) can there be people trying to work in
>>> eclipse but using something different from subclipse for svn
>>transactions?
>>
>>
>>Yes - there's another Eclipse plug-in called Subversive although I'm
>not
>>sure if anyone in the Harmony community has tried it.
>[Nadya] do you think we can change the text a bit to make a general
>statement and then a specific tool tip, like:
>"check out the source using the URL. If you're using subclipse, do blah
>- blah"
>>
>>- Prerequisites: you require a classlib build, though the page is
>supposed
>>> to be for classlib+drlvm
>>> - spelling: is it "pre-requisites" or "prerequisites"? check
>>> merriam-webster, they suggest one word.
>>
>>
>>Let's use "prerequisites" if that's the one in the dictionary
>[Nadya] ok
>[SV] "Prerequisites" is the only correct variant
>>
>>- Configuring Eclipse: are all steps in this section
classlib-specific?
>>
>>
>>Yes
>[Nadya] was just checking :)
>>
>>- Configuring Eclipse: some steps seemt to assume that the reader is
>using
>>> Windows? can we make the text OS neutral and separate OS specifics?
>>
>>
>>Yes - it would be good to make it clear that some of the steps are
>specific
>>to Windows.
>[Nadya] do you think you can write an update? I'm not a Linux user, so
>it's rather difficult for me to write an update.
>>
>>- Configuring Eclipse: please double-check formatting; sometimes, UI
>>> elements are in bold, at other times - monospace font; some UI
>elements
>>are
>>> in quotes, others not. sticking to one notation could help. bold
with
>no
>>> quotes seems to be shorter and easy to decipher, but i don't insist
>:)
>>I agree
>>
>[SV] I'll write an update. Any objections?))
>
>>- Configuring Eclipse: do you think we can separate Configuring
Eclipse
>>> proper and, say, getting the source code (set up svn, check out,
>etc)? in
>>> the current list, steps 5-6 might as well be step 1 - right? can we
>have
>>two
>>> grouping? also, the info about checkout is exactly the same for
drlvm
>and
>>> classlib except for slight differences in the path. perhaps, we can
>have
>>a
>>> section on Check Out Source Code. there, we could explain how to
>check
>>out
>>> using eclipse-related means and provide a link to some other webpage
>>> explaining other ways of check out and related problems (say,
working
>>behind
>>> a firewall).
>>
>>
>>I think I would have to see what that looked like before commenting.
>It
>>does seem to make sense, but I'm not sure if it would be confusing to
>have
>>so many sections in the page.
>[Nadya] ok, we can have two versions and then compare.
>>
>>thanks, Nadya
>
>
>Cheers,
>Sveta
>
>
>
>>>
>>> > Brush up and update Eclipse-related docs, make them user-friendly.
>>> > ------------------------------------------------------------------
>>> >
>>> >                 Key: HARMONY-2009
>>> >                 URL:
>http://issues.apache.org/jira/browse/HARMONY-2009
>>> >             Project: Harmony
>>> >          Issue Type: Improvement
>>> >          Components: Website/Documentation
>>> >            Reporter: Svetlana Konovalova
>>> >         Assigned To: Nadya Morozova
>>> >         Attachments: dev_eclipse.patch, dev_eclipse_patch.txt,
>>> get-involved_patch.txt, H2009-deveclipse.patch
>>> >
>>> >
>>> > The documentation doesn't cover all aspects of work with Eclipse.
>Need
>>> to brush up and update Eclipse-related docs, make them
user-friendly.
>>>
>>> --
>>> This message is automatically generated by JIRA.
>>> -
>>> If you think it was sent incorrectly contact one of the
>administrators:
>>> http://issues.apache.org/jira/secure/Administrators.jspa
>>> -
>>> For more information on JIRA, see:
>http://www.atlassian.com/software/jira
>>>
>>>
>>>
>>
>>
>>--
>>Sian January
>>
>>IBM Java Technology Centre, UK