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
