Skip to content

Latest commit

 

History

History
75 lines (43 loc) · 3.91 KB

CONTRIBUTING.md

File metadata and controls

75 lines (43 loc) · 3.91 KB

Contribution Guidelines

Exercises / examples

Please add as many exercises and examples to this repo, the master branch is the place to put your exercises that need to be solved. Or examples that have comments on what it is doing, or how to use a JDK9 features or how it has been used across the whole project. Have a look at how we have already created some of the exercises under the Session 3: Refactoring/migration sessions. If you know of a feature or cool trick in JDK 9, then this is the place to put it.

Testing

Test your work under the respective platforms i.e. Linux, Mac and Windows, if not, please specify in your pull request which platforms need testing and what to do.

Platform coverage

Try to always provide exercises / examples / solutions for all three platforms, otherwise please let us know the platforms which are not covered.

Pull Requests

Ensure solutions to exercises are placed in the exercise-solutions branch. Typically examples can be (and should) be placed in both master and exercise-solutions branches.

We also have branches called ant-version, and maven-branch which is a near-literal translation of the exercises in the master branch into the respective build systems.

Java 9 Resources file

At the moment there isn't a lot written or spoken about this subject but nevertheless we would like consider links that are useful for the wider community, so we think the below would help:

(a) widely recommended, regardless of personal opinion

(b) discussed in the community (mentioned via social media)

(c) a good starting point for the subject or related subjects (contains examples)

(d) implementations that would be a good example for everyone to follow and be inspired by

Pull Requests

There are two required criteria for a pull request:

  1. If an entry has a similar scope as other entries in the same category, the description must state the unique features that distinguishes it from the other entries.

  2. If an entry does not meet conditions (a) to (d) there has to be an explanation either in the description or the pull request why it should be added to the list.

Self-promotion is not encouraged, but your suggestion will of course be approved if the criteria match.

Furthermore, please ensure your pull request follows the following guidelines:

  • Please search previous suggestions before making a new one, as yours may be a duplicate
  • Please make an individual pull request for each suggestion
  • Use the format that exists in the Java 9 Resources file file, at the moment
  • New categories or improvements to the existing categorization are welcome
  • Check your spelling and grammar
  • Make sure your text editor is set to remove trailing whitespace

Thank you for your suggestions!

License

See License document to find out about the licensing terms and conditions.

Social media

Please share this repo with everyone in your social network, dev. communities and local user groups.

Some of the actions to do when you have landed here:

Let this repo be a brain-dump of every way to do things in JDK 9 and Jigsaw


I need you for Java SE 9 development