Call for Discussion: New Project: Developer's Guide

[Martijn Verburg]

We'd (MSFT) be very happy to contribute (our group is fairly new to
OpenJDK, so it's good timing)!

Cheers,
Martijn


On Thu, 12 Mar 2020 at 00:30, Jonathan Gibbons <jonathan.gibbons at oracle.com>
wrote:

> Jesper,
>
> This is a great idea. Thanks for starting the discussion.
>
> The Compiler Group is pleased to sponsor such a Project.
>
> -- Jon
>
>
> On 03/11/2020 04:51 PM, Jesper Wilhelmsson wrote:
> > Hi.
> >
> > I would like to discuss the possible creation of the Developer's Guide
> Project
> > with myself, Jesper Wilhelmsson, as the lead and the Core-Libs,
> Compiler, and
> > Hotspot groups as the sponsoring Groups.
> >
> > The initial goal of the project would be to create up-to-date guidelines
> for
> > OpenJDK development and contributions. The intent is to update the
> existing
> > OpenJDK Developer's Guide [1] which hasn't been updated since 2012.
> Parts of
> > the existing guide are in need of updates while other parts are yet to be
> > written. The initial source code for this project will be based on the
> current
> > OpenJDK Developer's Guide.
> >
> > In more recent years some process related information has been published
> on the
> > OpenJDK wiki [2], but this information was never reviewed or approved by
> the
> > community. Even though large parts of this information may be accurate,
> it needs
> > to go through proper review before it can be seen as official guidelines
> for
> > OpenJDK development.
> >
> > Once the initial goal has been reached the project will transition into a
> > maintenance project to keep the OpenJDK Developer's Guide up to date.
> >
> > The OpenJDK Developer's Guide is intended to contain tutorial style
> texts that
> > give examples and step-by-step directions for common parts of the
> development
> > process. Strict rules for OpenJDK development are better suited to a
> process
> > JEP. The development of such a JEP is outside of the scope of this
> project but
> > will be developed as part of a separate effort in parallel.
> >
> > Initial committers of the Developer's Guide Project include Mark
> Reinhold, Iris
> > Clark, and Jesper Wilhelmsson. Additional committers may be identified
> through
> > this discussion.
> >
> > The project will host at least one mailing list,
> guide-dev at openjdk.java.net,
> > for discussions and reviews of changes.
> >
> > Thanks,
> > /Jesper
> >
> > [1] http://openjdk.java.net/guide/
> > [2] https://wiki.openjdk.java.net/
> >
>
>