harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Egor Pasko <egor.pa...@gmail.com>
Subject Re: [jira] Commented: (HARMONY-2009) Brush up and update Eclipse-related docs, make them user-friendly.
Date Wed, 29 Nov 2006 11:49:36 GMT
On the 0x230 day of Apache Harmony Nadezhda Morozova wrote:
> Sian,
> Thanks for a prompt reply. See answers below.
> 
> Cheers, 
> Nadya
>  
> 
> >-----Original Message-----
> >From: Sian January [mailto:sianjanuary@googlemail.com]
> >Sent: Wednesday, November 29, 2006 1:51 PM
> >To: dev@harmony.apache.org
> >Subject: Re: [jira] Commented: (HARMONY-2009) Brush up and update
> Eclipse-
> >related docs, make them user-friendly.
> >
> >Hi Nadya,
> >
> >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 :) 

IMHO, a placeholder is not necessary

> >Thanks,
> >
> >Sian
> >
> >
> >
> >On 28/11/06, Nadya Morozova (JIRA) <jira@apache.org> wrote:
> >>
> >>    [
> >> http://issues.apache.org/jira/browse/HARMONY-
> >2009?page=comments#action_12454039]
> >>
> >> Nadya Morozova commented on HARMONY-2009:
> >> -----------------------------------------
> >>
> >> some review comments. please don't take too seriously - negotiations
> >> welcome.
> >>
> >> - 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
> >
> >- 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
> >
> >- 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
> >>
> >>
> >> > 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
> 

-- 
Egor Pasko


Mime
View raw message