1
0
mirror of https://github.com/dhamaniasad/awesome-postgres.git synced 2024-12-13 11:53:50 +02:00

Create CONTRIBUTING.md

This commit is contained in:
Asad Dhamani 2015-11-19 05:06:58 +05:30
parent 8c33a89234
commit 8f63a869c2

43
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,43 @@
This list [accepts and encourages pull requests](https://github.com/dhamaniasad/awesome-postgres).
# Contribution Guidelines
- **To add to the list:** Submit a pull request to [README.md](https://github.com/dhamaniasad/awesome-postgres/blob/master/README.md), optionally add comment if you wish to elaborate/explain.
- **To edit an item:** Submit a pull request to [READ.md](https://github.com/dhamaniasad/awesome-postgres/blob/master/README.md), add comment explaining the reasoning behind the change.
- **To remove from the list:** Open an issue
You may add, edit, or request to remove:
- Categories
- Items
### General conditions
This is an attempt to make a curated list of high-quality, maintained, useful PostgreSQL/related software.
- Submitting software:
- Must be free and open source. Must have an acknowledged open source license. I'm not a lawyer, so I'll go with the
FSF listings. Propriety, trial, shareware, halfway open sourced etc., will not be accepted, and will be removed.
- Must be reasonably recognized and adopted. Please do not add your newly created untested scripts.
- The code must have been active in some production environment and must be in a reasonably GA quality.
- Code must not be abandoned/discontinued.
- Do not include links to documentation. This is not an "awesome library" repository. We might go for that in the future.
- If e-book, must be free (as in free beer) and without commitment from the user (e.g. no requirement to enter personal details,
no requirement to login with social network ID, etc.)
- Likewise, all other resources (websites etc.), must all be open to all and must not require payment nor registration/credentials.
- The only exception being Newsletters, where an email address is required by definition. Newsletters are accepted under the
condition that an email address is their *only requirement*.
- This is not the place for slides, videos, specific blog posts, specific SQL queries. Will possibly open a dedicated list for these.
- Avoid politics and religious wars.
### Request guidelines
- Make an individual pull request for each suggestion.
- Use the following format: `[item](link) - description.`
- Each item should be limited to one link
- The link should be the name of the package/project/library/resource etc.
- Avoid superlatives or FUD and otherwise just stick to a reasonable description.
- Do not capitalize description (i.e. avoid "The Tool to End All Tools")
- English only
**Thank you for contributing!**