2013-11-04 18:36:23 +01:00
|
|
|
|
# A collection of `.gitignore` templates
|
2010-11-08 21:21:45 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
This is GitHub’s collection of [`.gitignore`][man] file templates.
|
|
|
|
|
We use this list to populate the `.gitignore` template choosers available
|
|
|
|
|
in the GitHub.com interface when creating new repositories and files.
|
2010-11-08 21:43:25 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
For more information about how `.gitignore` files work, and how to use them,
|
|
|
|
|
the following resources are a great place to start:
|
2010-11-08 23:56:21 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
- The [Ignoring Files chapter][chapter] of the [Pro Git][progit] book.
|
|
|
|
|
- The [Ignoring Files article][help] on the GitHub Help site.
|
|
|
|
|
- The [gitignore(5)][man] manual page.
|
2010-11-08 21:52:45 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
[man]: http://git-scm.com/docs/gitignore
|
|
|
|
|
[help]: https://help.github.com/articles/ignoring-files
|
|
|
|
|
[chapter]: http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Ignoring-Files
|
|
|
|
|
[progit]: http://git-scm.com/book
|
2010-11-08 21:46:40 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
## Folder structure
|
|
|
|
|
|
|
|
|
|
The files in the root directory are for `.gitignore` templates that are
|
|
|
|
|
project specific, such as language or framework specific templates.
|
|
|
|
|
Global (operating system or editor specific) templates should go into the
|
|
|
|
|
[`Global/`](./Global) directory.
|
|
|
|
|
|
|
|
|
|
## Contributing guidelines
|
2010-11-09 01:11:36 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
We’d love you to help us improve this project. To help us keep this collection
|
|
|
|
|
high quality, we request that contributions adhere to the following guidelines.
|
2012-09-23 23:31:30 +02:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
- **Provide a link to the application or project’s homepage**. Unless it’s
|
|
|
|
|
extremely popular, there’s a chance the maintainers don’t know about or use
|
|
|
|
|
the language, framework, editor, app, or project your change applies to.
|
|
|
|
|
|
|
|
|
|
- **Provide links to documentation** supporting the change you’re making.
|
|
|
|
|
Current, canonical documentation mentioning the files being ignored is best.
|
|
|
|
|
If documentation isn’t available to support your change, do the best you can
|
|
|
|
|
to explain what the files being ignored are for.
|
|
|
|
|
|
|
|
|
|
- **Explain why you’re making a change**. Even if it seems self-evident, please
|
|
|
|
|
take a sentence or two to tell us why your change or addition should happen.
|
|
|
|
|
It’s especially helpful to articulate why this change applies to *everyone*
|
|
|
|
|
who works with the applicable technology, rather than just you or your team.
|
|
|
|
|
|
|
|
|
|
- **Please consider the scope of your change**. If your change specific to a
|
|
|
|
|
certain language or framework, then make sure the change is made to the
|
|
|
|
|
template for that language or framework, rather than to the template for an
|
|
|
|
|
editor, tool, or operating system.
|
2012-09-23 23:31:30 +02:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
- **Please only modify *one file* per commit**. This will make merging and
|
|
|
|
|
conflict resolution easier for everyone.
|
2012-09-23 23:31:30 +02:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
In general, the more you can do to help us understand the change you’re making,
|
|
|
|
|
the more likely we’ll be to accept your contribution quickly.
|
|
|
|
|
|
|
|
|
|
## Contributing workflow
|
2010-11-09 01:11:36 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
Here’s how we suggest you go about proposing a change to this project:
|
2010-11-09 01:11:36 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
1. [Fork this project][fork] to your account.
|
|
|
|
|
2. [Create a branch][branch] for the change you intend to make.
|
|
|
|
|
3. Make your changes to your fork.
|
|
|
|
|
4. [Send a pull request][pr] from your fork’s branch to our `master` branch.
|
|
|
|
|
|
|
|
|
|
Using the web-based interface to make changes is fine too, and will help you
|
|
|
|
|
by automatically forking the project and prompting to send a pull request too.
|
|
|
|
|
|
|
|
|
|
[fork]: http://help.github.com/forking/
|
|
|
|
|
[branch]: https://help.github.com/articles/creating-and-deleting-branches-within-your-repository
|
|
|
|
|
[pr]: http://help.github.com/pull-requests/
|
2010-11-09 01:11:36 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
## License
|
2010-11-09 01:11:36 +01:00
|
|
|
|
|
2013-11-04 18:36:23 +01:00
|
|
|
|
[MIT](./LICENSE).
|