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:[EMAIL PROTECTED] > >Sent: Wednesday, November 29, 2006 1:51 PM > >To: [email protected] > >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) <[EMAIL PROTECTED]> 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
