From lars.westergren at gmail.com  Mon Apr  7 08:22:50 2008
From: lars.westergren at gmail.com (Lars Westergren)
Date: Mon, 7 Apr 2008 17:22:50 +0200
Subject: Repositories page - "suggested repository"
Message-ID: <7cf9cdd90804070822s3afcd371w4843b883fe92c919@mail.gmail.com>

Hi,

On the repositories page -
 http://openjdk.java.net/guide/repositories.html
there is no suggestion to which repository a "first time user" should
clone. When you are learning something for the first time it can be
frustrating to read "here are 20 subtle different ways of doing this"
but no hint of which is the sensible default to pick.

I would like to see a few lines about something like

"If you are checking out the OpenJDK source for the very first time,
you should probably clone the following repository:
http://hg.openjdk.java.net/jdk7/jdk7
This is the so called MASTER repository, a central or top-level
repository which has very strict checks of the things that are
committed. If you want to work with a more specific area or API you
may want to clone one of the other repositories listed. These
repositories are more likely to have up and coming features that may
be merged with the MASTER repository later after extensive testing."

Of course Brad Whetmore touched on this a bit with his suggestion to
add an image.

Cheers,
Lars


From iris at sun.com  Mon Apr  7 13:15:22 2008
From: iris at sun.com (iris clark)
Date: Mon, 7 Apr 2008 13:15:22 -0700 (PDT)
Subject: Repositories page - "suggested repository"
In-Reply-To: <7cf9cdd90804070822s3afcd371w4843b883fe92c919@mail.gmail.com>
	(message from Lars Westergren on Mon, 07 Apr 2008 17:22:50 +0200)
Message-ID: <200804072015.m37KFMKb013824@ribbit.SFBay.Sun.COM>


Hi, Lars.

Thanks for the suggests for updates to the repositories page!  

I've been out on vacation the past couple of weeks.  Once I get
through my backlog, I'll be updating this page to take your
suggestions (and others).  As others have been saying, we _really_
need a diagram (or two).

iris