On Fri, 17 Dec 2021 12:46:07 GMT, Kevin Rushforth <k...@openjdk.org> wrote:

>> This PR updates the `CONTRIBUTING.md` guide to address the following:
>> 
>> 1. Clarify the process for adding new features / API changes, specifically 
>> that they must be discussed on the mailing list as the first step.
>> 2. Add a link to the mailing list in the section regarding contributing bug 
>> fixes.
>> 3. Remove the text about cross-linking the PR and JBS issue, and add a note 
>> that the Skara tooling takes care of this
>> 4. Remove the section about manually resolving the JBS issue, and add a note 
>> that the Skara bot automatically does this when the PR is integrated.
>> 5. Suggest the use of the "/reviewers 2" and "/csr" commands when appropriate
>> 6. Update the note regarding which JDK(s) to use.
>
> Kevin Rushforth has updated the pull request incrementally with one 
> additional commit since the last revision:
> 
>   More review comments
>   
>   1. Renamed "Contributing to...codebase" section to "Coding style and 
> testing guidelines", and switched that section with the "New features section"
>   2. Updated recommend JDK
>   3. Added forward reference for Draft and WIP PRs

CONTRIBUTING.md line 176:

> 174: 
> 175: Adding a new feature to OpenJFX requires us to consider what it means to 
> support that API forever; we take compatibility seriously.
> 176: The main idea is to think in terms of "stewardship" when evolving the 
> JavaFX API. This will require significant effort on your part.

@johanvos to address your point about maintenance, what do you think about 
adding a sentence here? Something like:

This will require significant effort on your part. __It begins before you 
submit a pull request for review, and continues after the new feature is 
integrated.__

We can follow this up with more detail in the code review guidelines.

-------------

PR: https://git.openjdk.java.net/jfx/pull/303

Reply via email to