Changing the title of a JEP (was Re: JEP 156: G1 GC: Remove need for full GCs)

[mark.reinhold at oracle.com]

(cc'ing jdk8-dev in order to share the answer)

2012/6/19 5:18 -0700, jesper.wilhelmsson at oracle.com:
> What is the procedure for doing major changes to a published JEP?

There's no fixed process.  I would suggest that if a JEP already has
reviewers and/or endorsers then they should be advised of any major
change and given an opportunity to provide feedback (i.e., they're
stakeholders).

> Actually what I want to change is the title of JEP 156. Maybe not a
> major change, but a fairly visible one.
> 
> We came to the conclusion that the title of 156 may be promising too
> much since we actually don't get rid of full GC's with this work. We
> just make sure the VM wont be dependent on full GC to perform important
> maintenance.
> 
> The new title should be:
> "Remove dependency on full GC for common features in G1"
> 
> I have done minor changes to published JEPs before, but I thought I'd
> better ask before changing a title.

Thanks for asking.  You're free to change a JEP's title, just like
any other part.  Be aware, however, that I often edit JEP titles and
summaries so that they read well and will make sense in the context
of Release Project feature lists and (ultimately, if appropriate) in
their associated Platform JSRs.

So if you edit a title I might revise it later on, but I always check
with a JEP's owner if I have any question about the intended meaning
of a title.

In this particular case, for the sake of brevity I'd condense your
proposed title to something like "G1 GC: Reduce need for full GCs".

- Mark