On the 0x21B day of Apache Harmony Nadezhda Morozova wrote:
> All,
> I'd like to share everyone's grief at the sight of outdated Getting
> Started document. However, I'd not hurry to eliminate the page as such.
> We might reconsider some of its contents, change structure, and update
> individual bits, but please think carefully before removing the page.
>
> I think Getting Started (as the title shows) is aimed to help a newbie
> work with our vm. I know that many primarily interested in other things
> - conformance, architecture, internal specifics. However, we should also
> think how the vm is used. AFAIK, Getting started is now the *only* doc
> that tries to show how to use our vm. You tell people how to download
> and build, but almost nothing about how to run and configure (with the
> exception of EM/JIT).
>
> My suggestion would be to think of what you want to tell people about
> usage - with or without eclipse specifics. And store this info on the
> page. I know it is hard - and I offer my help and support in this
> burdensome initiative. Any thoughts? i might be inobjective and
> emotional :)
Nadya,
I believe, almost everyone coming across Harmony knows how to use
J5SE. We are striving for this compatibility, and we are happy that
all DRLVM-specific pecularities are gone.
So, I vote for:
* removing the "Getting Started" (also because of irritating windows
screenshots:)
* preparing the "Commonly Used Options for DRLVM" (omitting the word
"supported" intentionally)
Just idea: "Getting Started" may contain a collection of links to the
main website and other resources with short descriptions ("Site Map"
or something) so that people are comfortable floating around in the web.
> -----Original Message-----
> From: Mikhail Fursov [mailto:[EMAIL PROTECTED]
> Sent: Wednesday, November 08, 2006 6:03 PM
> To: harmony-dev@incubator.apache.org
> Subject: Re: [doc][drlvm] The document "Getting started with DRL" is
> outdated
>
> It's not a hard to write a documenation once, it's hard to support it :)
> More problems:
> 1) -Xem options are obsolete.
> 2) -Xjit options are also obsolete.
> 3) Do we really need this page today? AFAIU users expect Harmony VM is
> able
> to run the same apps as RI..
> ?
>
> On 11/8/06, Pavel Ozhdikhin <[EMAIL PROTECTED]> wrote:
> >
> > Hello all,
> > I've read through the "Getting Started with
> > DRL<
> >
> http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.
> html
> > >"
> > document on the Harmony web and found it completely outdated, for
> example:
> >
> >
> > - the term DRL is used instead of DRLVM
> > - eclipse.bat and eclipse.sh are obsolete - we don't need them
> anymore
> > to run Eclipse. It can be started with DRLVM the same way as with
> any
> > other
> > VM.
> > - We don't need to set PATH and LD_LIBRARY_PATH anymore, at least
> on
> > Windows/MSVC
> > - ij was renamed to java
> >
> > We took a big step to unification with other Java VMs and now
> > we don't need anything specific to run Eclipse, for example. After
> > removing
> > all irrelevant info the document would contain only the list of
> > command-line
> > options. I think we can move this list to a separate document (Wiki,
> > Developer's Guide?) and remove the "Getting Started" itself.
> >
> > Any opinions?
> >
> > Thanks,
> > Pavel
> > <
> >
> http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.
> html
> > >
> >
> >
>
>
> --
> Mikhail Fursov
>
--
Egor Pasko
