java/CONTRIBUTING.md

# Contribution Guidelines

Unfortunately, not every library/tool/framework can be considered. The aim of the list is to provide a concise list of noteworthy modern software. This means that suggested software is:

(a) widely recommended regardless of personal opinion (e.g. 100+ Github stars)

(b) highly discussed in the community due to its innovative nature

(c) absolutely unique in its approach and function

(d) a niche product that fills a gap  

(e) developer friendly (i.e has a commercial friendly license or clear pricing)  

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 *(e)* 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 frowned upon and will be reviewed critically but the suggestion will of course be approved if they criteria match.

If a certain entry does not get accepted, you should first look if there has been a discussion before. These discussions are in the issue section and normally marked with the question tag. If there hasn't been such a topic, you are free to create a new issue tagged as question.

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 following format for libraries: \[LIBRARY\]\(LINK\) - DESCRIPTION.
* Entries should be sorted in ascending alphabetical order, i.e. a to z.
* New categories, or improvements to the existing categorization are welcome.
* Keep descriptions short, simple and unbiased.
* End all descriptions with a full stop/period.
* Check your spelling and grammar.
* Make sure your text editor is set to remove trailing whitespace.

Thank you for your suggestions!
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00			`# Contribution Guidelines`

Clarify contribution guidelines 2017-05-15 23:56:07 -04:00			`Unfortunately, not every library/tool/framework can be considered. The aim of the list is to provide a concise list of noteworthy modern software. This means that suggested software is:`
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00
Clarify contribution guidelines 2017-05-15 23:56:07 -04:00			`(a) widely recommended regardless of personal opinion (e.g. 100+ Github stars)`
Update CONTRIBUTING.md Fixed formatting 2014-07-11 15:48:43 -04:00
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00			`(b) highly discussed in the community due to its innovative nature`
Update CONTRIBUTING.md Fixed formatting 2014-07-11 15:48:43 -04:00
Fixed spelling and made the acceptance criteria for new items clearer 2015-03-26 16:15:05 -04:00			`(c) absolutely unique in its approach and function`
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00
Clarify contribution guidelines 2017-05-15 23:56:07 -04:00			`(d) a niche product that fills a gap`

			`(e) developer friendly (i.e has a commercial friendly license or clear pricing)`
Fixed spelling and made the acceptance criteria for new items clearer 2015-03-26 16:15:05 -04:00
Update contribution rules 2017-05-02 07:18:28 -04:00			`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.`

Clarify contribution guidelines 2017-05-15 23:56:07 -04:00			`2. If an entry does not meet conditions (a) to (e) there has to be an explanation either in the description or the pull request why it should be added to the list.`
Update contribution rules 2017-05-02 07:18:28 -04:00
Fixed spelling and made the acceptance criteria for new items clearer 2015-03-26 16:15:05 -04:00			`Self-promotion is frowned upon and will be reviewed critically but the suggestion will of course be approved if they criteria match.`
Update CONTRIBUTING.md Added statement regarding self-promotion 2014-08-05 04:16:01 -04:00
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00			`If a certain entry does not get accepted, you should first look if there has been a discussion before. These discussions are in the issue section and normally marked with the question tag. If there hasn't been such a topic, you are free to create a new issue tagged as question.`

Fixed spelling and made the acceptance criteria for new items clearer 2015-03-26 16:15:05 -04:00			`Furthermore, please ensure your pull request follows the following guidelines:`
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00
			`* 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 following format for libraries: \[LIBRARY\]\(LINK\) - DESCRIPTION.`
Update CONTRIBUTING.md 2014-07-11 17:46:05 -04:00			`* Entries should be sorted in ascending alphabetical order, i.e. a to z.`
Fixed spelling and made the acceptance criteria for new items clearer 2015-03-26 16:15:05 -04:00			`* New categories, or improvements to the existing categorization are welcome.`
Update contribution rules 2017-05-02 07:18:28 -04:00			`* Keep descriptions short, simple and unbiased.`
Create CONTRIBUTING.md Init 2014-07-11 15:47:16 -04:00			`* End all descriptions with a full stop/period.`
			`* Check your spelling and grammar.`
			`* Make sure your text editor is set to remove trailing whitespace.`

			`Thank you for your suggestions!`