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: harmony-dev@incubator.apache.org
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: harmony-dev@incubator.apache.org
>>> 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: harmony-dev@incubator.apache.org
>>>> 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
> 

Reply via email to