CFV: New Project: Developer's Guide

[Kumar Srinivasan]

Vote: yes


> On Mar 30, 2020, at 2:35 PM, Jesper Wilhelmsson <jesper.wilhelmsson at oracle.com> wrote:
> 
> I hereby propose the creation of the Developer's Guide Project with myself,
> Jesper Wilhelmsson, as the lead and the Core Libraries, Compiler, and HotSpot
> Groups as the sponsoring Groups.
> 
> The suggested project has been out for discussion on discuss at openjdk.java.net
> for two weeks [1]. It was well-received and I haven't noted any concerns with
> creating the project in that discussion.
> 
> 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 [2] 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 [3], 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.
> 
> I (Jesper Wilhelmsson) am part of the Java Platform Group at Oracle and have
> been working with virtual machine development since 2001. My initial focus was
> on memory management and garbage collection but over the last few years I've
> been more involved in gatekeeping and process questions around the OpenJDK.
> I authored several of the guides available on the OpenJDK HotSpot wiki and I
> regularly give talks on how to contribute to the OpenJDK.
> 
> Initial committers of the Developer's Guide Project include Mark Reinhold (mr),
> Iris Clark (iris), and Jesper Wilhelmsson (jwilhelm). A complete list will be
> provided to the registrar at the successful conclusion of this CFV.
> 
> The project will host at least one mailing list, guide-dev at openjdk.java.net,
> for discussions and reviews of changes.
> 
> Votes are due by 5pm PDT on Tuesday April 14 2020.
> 
> Only current OpenJDK Members [4] are eligible to vote on this motion.
> Votes must be cast in the open on the discuss list. Replying to this message
> is sufficient if your mail program honors the Reply-To header.
> 
> For Lazy Consensus voting instructions, see [5].
> 
> Thanks,
> /Jesper
> 
> [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fmail.openjdk.java.net%2Fpipermail%2Fdiscuss%2F2020-March%2F005298.html&data=02%7C01%7Ckusrinivasan%40vmware.com%7C9c092db3d3434683300208d7d4fb64ff%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637212048509011293&sdata=T%2B8Fq90AXkk6sP2a6ET45%2BoHMgIqpWmhuXdPxeux%2FDk%3D&reserved=0
> [2] https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fopenjdk.java.net%2Fguide%2F&data=02%7C01%7Ckusrinivasan%40vmware.com%7C9c092db3d3434683300208d7d4fb64ff%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637212048509011293&sdata=4d76r6K2g7mEKUEGgoA9JZrcSU0dKG%2FZadZzi5QcV4A%3D&reserved=0
> [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwiki.openjdk.java.net%2F&data=02%7C01%7Ckusrinivasan%40vmware.com%7C9c092db3d3434683300208d7d4fb64ff%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637212048509021290&sdata=j4Ao%2B2c3dRpmkZy3uzmdS%2BNrHyuhp8DgNDaDK5s6%2BHY%3D&reserved=0
> [4] https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fopenjdk.java.net%2Fcensus%23members&data=02%7C01%7Ckusrinivasan%40vmware.com%7C9c092db3d3434683300208d7d4fb64ff%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637212048509021290&sdata=1uM2K%2FB4JGMjj0QMIaBwnykHP8tAIsW3KJZXorV4%2FcM%3D&reserved=0
> [5] https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fopenjdk.java.net%2Fprojects%2F%23new-project-vote&data=02%7C01%7Ckusrinivasan%40vmware.com%7C9c092db3d3434683300208d7d4fb64ff%7Cb39138ca3cee4b4aa4d6cd83d9dd62f0%7C0%7C0%7C637212048509021290&sdata=xDJa2lE3hoB4VEgH4DCP36wLArJXfDFoj8AfCB0hzRQ%3D&reserved=0
>