Repositories page - "suggested repository"
lars.westergren at gmail.com
Mon Apr 7 08:22:50 PDT 2008
On the repositories page -
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:
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.
More information about the guide-discuss