Renewing an old thread concerning doc issue [H2009]. I've looked closer at the patch, merged with a newer version of the site and added some review feedback. Two key ideas: - drlvm section empty; we still badly need someone to share the experience of working drlvm+eclipse; at least setting up the environment. - classlib sections are generally fine, but can be improved further. Several suggestions added to the JIRA. Discussions and patches most welcome.
[H2009] http://issues.apache.org/jira/browse/HARMONY-2009 Cheers, Nadya >-----Original Message----- >From: Sian January [mailto:[EMAIL PROTECTED] >Sent: Friday, November 10, 2006 12:30 PM >To: [email protected] >Subject: Re: [build] Building on Eclipse - FYI > >That sounds great. It would be really good to be able to flesh out the >DRLVM+Eclipse section if anyone has any relevant experience or information. >I don't have any objections about applying the get-involved patch. > >Thanks, > >Sian > > >On 10/11/06, Konovalova, Svetlana <[EMAIL PROTECTED]> wrote: >> >> Sian, >> I've looked through the patches, and they seem to be great! Thanks! >> But I agree with Nadya, that we should hold off patching >> eclipse-oriented docs. Let's wait and see what eclipse+drlvm gurus will >> say. >> IMHO we can ask the committers to apply get_involved.patch, which was >> created to remove the "Am I Eligible?" section from [1] to [2]. Any >> objections? >> >> Best regards, >> Sveta >> >> [1]http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_ec >> lip >> se.html >> [2]http://incubator.apache.org/harmony/get-involved.html >> >> -----Original Message----- >> From: Sian January [mailto:[EMAIL PROTECTED] >> Sent: Thursday, November 09, 2006 6:41 PM >> To: [email protected] >> Subject: Re: [build] Building on Eclipse - FYI >> >> Yes that sounds fine. Shall I update my patch to remove the DRLVM >> references, or would you prefer to? Since I did not write very much >> about >> DRLVM we could leave that out for now and then the person who updates >> "Getting Started with DRLVM" could choose to add something there if >> people >> feel it's appropriate. >> >> Regards, >> >> Sian >> >> >> On 09/11/06, Konovalova, Svetlana <[EMAIL PROTECTED]> wrote: >> > >> > Folks, >> > Looking through the site and figuring out how to improve the docs that >> > include info on Eclipse, the following ideas came up to my mind: >> > 1) Since the "Developing Apache Harmony Class-library >> > Code with Eclipse" page [1] is mostly class-library oriented, I >> suggest >> > reviewing it to remove purely DRLVM-oriented info and leave the page >> > where it is now [subcomponents/classlibrary/dev_eclipse.html]. >> > 2) Add the link from the Quick Help pages to the "Developing Apache >> > Harmony Class-library Code with Eclipse" page [1]. >> > 3) Gather purely DRLVM-oriented info to store it in the "Getting >> Started >> > with DRL" doc (hope it won't be wiped off the face of the earth; for >> > details, see the discussion thread: [doc][drlvm] The document "Getting >> > started with DRL" is outdated) >> > In this case, we'll get two docs providing info on developing with >> > Eclipse: >> > [1] - describing how to develop class-library code with Eclipse, and >> "GS >> > with DRL"(or whatever it'll be) describing how to develop DRLVM >> > application in Eclipse. >> > Any objections? What do you think? Please right me if I'm wrong. >> > >> > Best regards, >> > Sveta Konovalova >> > >> > [1] >> > >> http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_eclip >> > se.html >> > >> > >> > -----Original Message----- >> > From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] >> > Sent: Thursday, November 09, 2006 3:58 PM >> > To: [email protected] >> > Subject: Re: FW: [build] Building on Eclipse - FYI >> > >> > >> > >> > Egor Pasko wrote: >> > > On the 0x21C day of Apache Harmony Sian January wrote: >> > >> Hello again, >> > >> >> > >> I have had a closer look at the "Developing Apache Harmony >> > Class-library >> > >> Code with Eclipse" page, and I have noticed that the "Configuring >> > Eclipse" >> > >> and "Develop and Test Code" sections are quite class-library >> > specific. >> > >> Would it be better to leave those sections as they are and add a >> > "Developing >> > >> DRLVM with Eclipse" section on the same page? >> > > >> > > To the moment I am not aware of anybody who would use Eclipse for >> > > DRLVM development. So, it's too early to add a page like this. >> > >> > This will ensure that no one does then - if it's simple to add, lets >> add >> > >> > it... >> > >> > geir >> > >> > > >> > >> Thanks, >> > >> >> > >> Sian >> > >> >> > >> >> > >> >> > >> On 07/11/06, Konovalova, Svetlana <[EMAIL PROTECTED]> >> > wrote: >> > >>> >> > >>> Sian, >> > >>> Sorry for delay in response. >> > >>>> I'd like to help with documentation but I don't want to duplicate >> > any >> > >>> work >> > >>>> that you are in the middle of, so let me know if there's anything >> > >>> specific >I can do... >> > >>> Thanks for your desire to help! >> > >>> Well, let's work at the page "Developing Apache Harmony >> > Class-library >> > >>> Code with Eclipse" >> > >>> >> > >> [http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_ecli >> > >>> pse.html] first, if you do not mind. >> > >>> AFAIK the majority of items on the page can equally apply to DRLVM >> > and >> > >>> classlib. IMHO would be great to edit the page to remove >> unnecessary >> > >>> focus on classlib, to make the page equally relevant for vm >> > developers. >> > >>> To my mind, the introductory sections should be removed, as they >> are >> > >>> about generalities that do not always relate to the header of the >> > page. >> > >>> Could you please take a close look at the page and create the >> patch >> > to >> > >>> improve the content and to remove all classlib-specific info? You >> > can >> > >>> use Harmony-2009 for it. It would be a great impact into >> development >> > of >> > >>> the site documentation for sure! If you need my help, just let me >> > know. >> > >>> The second idea is to move the page up, not to store it in >> > >>> subcomponents/classlib. To make it easily accessible, we can store >> > it in >> > >>> top xdocs folder and link to the page from documentation.html, >> quick >> > >>> helps and other build-development web pages. >> > >>> If you do not have any objections, I can create a patch with the >> > >>> necessary links. >> > >>> What do you think? >> > >>> >> > >>> Best regards, >> > >>> Sveta >> > >>> >> > >>> -----Original Message----- >> > >>> From: Sian January [mailto:[EMAIL PROTECTED] >> > >>> Sent: Thursday, November 02, 2006 2:23 PM >> > >>> To: [email protected] >> > >>> Subject: Re: [build] Building on Eclipse - FYI >> > >>> >> > >>> Hi Sveta, >> > >>> >> > >>> Thanks for all your work on this. I think you're right about the >> > >>> Eclipse >> > >>> information - I think most of it is fairly generic and it would be >> > good >> > >>> to >> > >>> have it in the "Project Documentation" section. I believe the new >> > >>> details >> > >>> about the ecj jar and the PDE-related settings are >> classlib-specific >> > (- >> > >>> Dpde.jreProfile=none etc), but that could probably be mentioned in >> > the >> > >>> document. >> > >>> >> > >>> I'd like to help with documentation but I don't want to duplicate >> > any >> > >>> work >> > >>> that you are in the middle of, so let me know if there's anything >> > >>> specific I >> > >>> can do, or if you're nearly finished then I can leave this area to >> > you >> > >>> and >> > >>> get involved in the future. >> > >>> >> > >>> Regards, >> > >>> >> > >>> Sian >> > >>> >> > >>> On 31/10/06, Konovalova, Svetlana <[EMAIL PROTECTED]> >> > wrote: >> > >>>> Sian, >> > >>>> >> > >>>> Thank you so much for your positive feedback and appreciating the >> > >>> page. >> > >>>> This page is only related to classlib. But IMHO many of the >> things >> > are >> > >>>> pretty generic, and with minimal edits can be fit >> > >>>> for VM as well. I suggest that we move this doc up to make it >> more >> > >>>> visible and edit it so as to apply to the whole project, rather >> > than >> > >>> to >> > >>>> classlib only. To my mind, the "Project Documentation" section is >> a >> > >>> good >> > >>>> place >> > >>>> for this doc >> > >>>> >> > >>> >> > >> [http://incubator.apache.org/harmony/documentation/documentation.html]. >> > >>>> How about that? >> > >>>> >> > >>>> As for the "GS with DRLVM" doc, it needs an update, and can be >> > >>> abridged >> > >>>> to reduce purely eclipse-oriented content. We can remove >> > unnecessary >> > >>>> screenshots as well. >> > >>>> >> > >>>> Feel free to take an active part in updating the doc, if you have >> > time >> > >>>> and desire :) >> > >>>> >> > >>>> Best regards, >> > >>>> Sveta >> > >>>> >> > >>>> -----Original Message----- >> > >>>> From: Sian January [mailto:[EMAIL PROTECTED] >> > >>>> Sent: Monday, October 30, 2006 8:14 PM >> > >>>> To: [email protected] >> > >>>> Subject: Re: [build] Building on Eclipse - FYI >> > >>>> >> > >>>> Hi Sveta, >> > >>>> >> > >>>> Thanks for doing that - I have had a look through your patch and >> it >> > >>>> looks >> > >>>> really good. >> > >>>> >> > >>>> Your suggestions for changes to the DRLVM document look good too. >> > I >> > >>>> couldn't really find any good links for getting started with Java >> > >>>> programming in Eclipse on their website, the only thing that came >> > >>> close >> > >>>> was >> > >>>> this - http://help.eclipse.org/help32/index.jsp, which has some >> > >>> getting >> > >>>> started tutorials within the page. There might be some better >> > >>> articles >> > >>>> out >> > >>>> there on other sites though, or we could just direct people to >> the >> > >>> help >> > >>>> system or 'cheat sheets' within their Eclipse installation. >> > >>>> >> > >>>> Thanks, >> > >>>> >> > >>>> Sian >> > >> >> > >> >> > >> -- >> > >> Sian January >> > >> >> > >> IBM Java Technology Centre, UK >> > > >> > >> >> >> >> -- >> Sian January >> >> IBM Java Technology Centre, UK >> > > > >-- >Sian January > >IBM Java Technology Centre, UK
