awesome-docker/CONTRIBUTING.md

We appreciate and recognize all contributors.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Contribution Guidelines

• To add to the list: Submit a pull request
• 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

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 resources, so feel free to add other resources about container or deployment in general. It would be nice if it is related or compatible with docker in some way. But if it's awesome, OK!

• Each item should be limited to one link
• The link should be the name of the package or project or website
• Descriptions should be clear and concise (read it out loud to be sure)
• Descriptions should follow the link, on the same line
• 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...

Please contribute links to packages/projects you have used or are familiar with. This will help ensure high-quality entries.

Quality standard

To be on the list, it would be nice if entries adhere to these quality standards:

• Generally useful to the community
• Clearly stating when a entry is relating to (Linux) containers and not Docker
• Clearly "what is it" --> which category it belongs : article, docker image, dev tools, video, twitter account, ...
• Clearly stating "what is it for": mention the problem it solves. Just try your best, make it clear for the next person.
• Solves a real problem (even a small one)
• if it is a WIP (work in progress, not safe for production), mention it. (Remember the time before Docker 1.0 ? ;-) )

Awesome Related Contribution Guidelines

Table of Contents

• Adding to this list
• Creating your own awesome list
• Adding something to an awesome list
• Updating your Pull Request

Adding to this list

Please ensure your pull request adheres to the following guidelines:

• Search previous suggestions before making a new one, as yours may be a duplicate.
• Make sure the list is useful before submitting. That implies it has enough content and every item has a good succinct description.
• Make an individual pull request for each suggestion.
• Use title-casing (AP style).
• Use the following format: [List Name](link)
• Link additions should be added to the bottom of the relevant category.
• 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.
• The pull request and commit should have a useful title.
• The body of your commit message should contain a link to the repository.

Thank you for your suggestions!

Creating your own awesome list

To create your own list, check out the instructions.

Adding something to an awesome list

If you have something awesome to contribute to an awesome list, this is how you do it.

You'll need a GitHub account!

1. Access the awesome list's GitHub page. For example: https://github.com/sindresorhus/awesome
2. Click on the readme.md file:
3. Now click on the edit icon.
4. You can start editing the text of the file in the in-browser editor. Make sure you follow guidelines above. You can use GitHub Flavored Markdown.
5. Say why you're proposing the changes, and then click on "Propose file change".
6. Submit the pull request!

Updating your Pull Request

Sometimes, a maintainer of an awesome list will ask you to edit your Pull Request before it is included. This is normally due to spelling errors or because your PR didn't match the awesome-* list guidelines.

Here is a write up on how to change a Pull Request, and the different ways you can do that.