awesome-docker/CONTRIBUTING.md

32 lines
1.9 KiB
Markdown
Raw Normal View History

2014-09-26 03:45:26 -04:00
We appreciate and recognize [all contributors](https://github.com/veggiemonk/awesome-docker/graphs/contributors).
# Contribution Guidelines
- **To add to the list:** Submit a pull request
2015-04-25 05:27:48 -04:00
- **To remove from the list:** Submit a pull request
- want to change something: Submit a pull request
- want to try something else: Submit a pull request
- don't know what to do: Submit a pull request
2014-09-26 03:45:26 -04:00
2015-04-25 05:27:48 -04:00
`awesome-docker` is a hand-crafted list for high-quality information about docker and its resources. I don't feel it should be constraint to docker only ressources, so feel free to add other resources about container or deployement in general. It would be nice if it is related or compatible with docker in some way. But if it's awesome, OK!
2014-09-26 03:45:26 -04:00
- Each item should be limited to one link
- The link should be the name of the package or project or website
2014-11-12 03:25:37 -05:00
- Descriptions should be clear and concise (read it out loud to be sure)
2014-09-26 03:45:26 -04:00
- Descriptions should follow the link, on the same line
2015-04-25 05:27:48 -04:00
- if you want to add more than one link, please don't do all PR on the exact same line, it usually results in conflicts and your PR cannot be automatically merged...
2014-09-26 03:45:26 -04:00
Please contribute links to packages/projects you have used or are familiar with. This will help ensure high-quality entries.
## Quality standard
2014-11-12 03:25:37 -05:00
To be on the list, it would be *nice* if entries adhere to these quality standards:
2014-09-26 03:45:26 -04:00
- Generally useful to the community
- Clearly stating when a entry is relating to (Linux) containers and not Docker
2014-11-12 03:25:37 -05:00
- Clearly "what is it" --> which category it belongs : article, docker image, dev tools, video, twitter account, ...
2014-09-26 03:45:26 -04:00
- Clearly stating "what is it for": mention the problem it solves. Just try your best, make it clear for the next person.
2014-11-12 03:25:37 -05:00
- Solves a real problem (even a small one)
2015-04-25 05:27:48 -04:00
- if it is a **WIP** (work in progress, not safe for production), mention it. (Remember the time before Docker 1.0 ? ;-) )