To help your project contributors do good work, you can add a CONTRIBUTING file (or CONTRIBUTING.md file, if you're using Markdown) with contribution guidelines to the root of your project's repository. Then, whenever someone opens a pull request or creates an issue, they will see a link to that file.

contributing-guidelines

For the repository owner, contribution guidelines are a way to quickly communicate how people should contribute.

For contributors, these guidelines help them verify that they're submitting well-formed pull requests and opening useful issues.

For both owners and contributors, contribution guidelines save time and hassle generated by improperly created pull requests or issues that have to be rejected and re-submitted.

Adding a CONTRIBUTING file

  1. On GitHub Enterprise, navigate to the main page of the repository.

  2. Above the file list, click . The create new file button

  3. In the file name field, type CONTRIBUTING or CONTRIBUTING.md (with all caps!). Adding the .md extension will create a Markdown file. New file name

  4. In the new file, add contribution guidelines. These could include:

    • Steps for creating good issues or pull requests.
    • Links to external documentation, mailing lists, or a code of conduct.
    • Community and behavioral expectations.
  5. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Commit message for your change

  6. Click Propose new file.

Examples of contribution guidelines

If you're stumped, here are some good examples of contribution guidelines: