aseprite/CONTRIBUTING.md

128 lines
5.5 KiB
Markdown
Raw Normal View History

# Code of Conduct
We have a [code of conduct](CODE_OF_CONDUCT.md) that we all must
read. Be polite to everyone. If you are not in your best day, take a
2018-06-17 23:23:55 +00:00
deep breath and try again. Smile :smile:
# New Issues
Before you submit an issue:
2018-06-17 23:23:55 +00:00
* Search in the current
[list of issues](https://github.com/aseprite/aseprite/issues),
[bug reports](https://community.aseprite.org/c/bugs), or
[feature requests](https://community.aseprite.org/c/features).
* If the issue already exists, add a :+1: or a :heart:, and you can
click the `Subscribe` or `Watching` button to get notifications
via email.
2016-08-04 15:19:31 +00:00
# Compilation problem
2018-06-17 23:23:55 +00:00
Before you submit an issue or a post about a **compilation problem**,
check the following items:
* See how to get the source code correctly in the [INSTALL](INSTALL.md) guide.
* Check if you are using the latest repository clone.
* Remember that we use submodules, so you need to initialize and update them.
* Remember that might be some [pull requests](https://github.com/aseprite/aseprite/pulls)
being reviewed to fix your same problem.
2018-06-17 23:23:55 +00:00
If you have a compilation problem, you can ask in the
[Development category](https://community.aseprite.org/c/development)
in the [Community site](https://community.aseprite.org/) for help
or creating a [GitHub issue](https://github.com/aseprite/aseprite/issues/new).
2013-11-23 19:01:49 +00:00
# Contributing
One of the easiest ways to contribute is writing articles,
2018-06-17 23:23:55 +00:00
[Steam reviews](https://steamcommunity.com/app/431730/reviews/),
blog posts, recording video tutorials,
[creating pixel art](https://aseprite.deviantart.com/), or showing your love
2013-11-23 19:09:52 +00:00
to Aseprite e.g. naming Aseprite in your website and linking it to
2018-06-17 23:23:55 +00:00
https://www.aseprite.org/, following
2013-11-23 19:01:49 +00:00
[@aseprite](https://twitter.com/aseprite) twitter account, or
2018-06-17 23:23:55 +00:00
[buying an extra Aseprite copy to your friend](https://www.aseprite.org/download/).
2013-11-23 19:01:49 +00:00
Other ways to contribute require direct contact with us. For example:
2018-06-17 23:23:55 +00:00
* [Writing documentation](https://github.com/aseprite/docs).
* Making art with Aseprite and for Aseprite (logos, skins, mockups).
2013-11-23 19:01:49 +00:00
* Sending patches for features or bug fixes.
* Reviewing issues in the [issue tracker](https://github.com/aseprite/aseprite/issues) and making comments.
2018-06-17 23:23:55 +00:00
* Helping other users in the [Community](https://community.aseprite.org/) site.
2013-11-23 19:01:49 +00:00
## Documentation
You can start seeing the
2018-06-17 23:23:55 +00:00
[documentation](https://www.aseprite.org/docs/), and
[contact us](mailto:support@aseprite.org) if you want to help
writting documentation
or recording [tutorials](https://www.aseprite.org/docs/tutorial/).
2013-11-23 19:01:49 +00:00
2014-08-14 03:41:30 +00:00
If you are going to write documentation, we recommend you to take
screenshots or record a GIF animations to show steps:
2013-11-23 19:01:49 +00:00
* As screen recording software, on Windows you can generate GIF files
2014-08-14 03:41:30 +00:00
using [LICEcap](http://www.cockos.com/licecap/).
* You can upload the PNG/GIF images to [Imgur](http://imgur.com/).
2013-11-23 19:01:49 +00:00
## Reviewing Issues
2013-11-23 19:01:49 +00:00
2018-06-17 23:23:55 +00:00
You can [review issues](https://github.com/aseprite/aseprite/issues),
make comments, or create
new [features](https://community.aseprite.org/c/features),
[bug reports](https://community.aseprite.org/c/bugs), etc. You are
encouraged to create mockups for any issue you see and attach them.
2013-11-23 19:01:49 +00:00
## Hacking
The first thing to keep in mind if you want to modify the source code:
2021-03-05 21:39:36 +00:00
checkout the **main** branch. It is the branch that we use to
2014-08-14 03:41:30 +00:00
develop new features and fix issues that are planned for the next big
release. See the [INSTALL](INSTALL.md) guide to know how to compile.
2013-11-23 19:01:49 +00:00
To start looking the source code, see how it is organized in
2021-03-05 21:39:36 +00:00
[src/README.md](https://github.com/aseprite/aseprite/tree/main/src/#aseprite-source-code)
2013-11-23 19:01:49 +00:00
file.
## Forking & Pull Requests
You can fork the GitHub repository using the Fork button at
[https://github.com/aseprite/aseprite](https://github.com/aseprite/aseprite).
The Pull Requests (PR) systems works in this way:
1. First of all you will need to sign our
[Contributor License Agreement](https://github.com/igarastudio/cla) (CLA).
2021-03-05 21:39:36 +00:00
1. Then you can start working on Aseprite. Create a new branch from `main`, e.g. `fix-8` to fix the issue 8.
2019-01-06 16:08:30 +00:00
Check this guide about [how to name your branch](https://github.com/agis/git-style-guide#branches).
1. Start working on that new branch, and push your commits to your fork.
2021-03-05 21:39:36 +00:00
1. Create a new PR to merge your `fix-8` branch to the official `main`.
1. If the PR is accepted (does not require review/comments/modifications),
2021-03-05 21:39:36 +00:00
your branch is merged into `main`.
1. You will need to pull changes from the official `main` branch, and
merge them in your own `main` branch. Finally you can discard your
2013-11-23 19:09:52 +00:00
own `fix-8` branch (because those changes should be already merged
2021-03-05 21:39:36 +00:00
into `main` if the PR was accepted).
1. Continue working from the new `main` head.
2013-11-23 19:01:49 +00:00
2021-03-05 21:39:36 +00:00
To keep in mind: **always** start working from the `main` head, if you
2013-11-23 19:01:49 +00:00
want to fix three different issues, create three different branches
2021-03-05 21:39:36 +00:00
from `main` and then send three different PR. Do not chain all the
2013-11-23 19:09:52 +00:00
fixes in one single branch. E.g. `fix-issues-3-and-8-and-25`.
2013-11-23 19:01:49 +00:00
2018-06-17 23:23:55 +00:00
## Community
You can use the [Development category](https://community.aseprite.org/c/development)
to ask question about the code, how to compile, etc.
If you want to start working in something
([issue](https://github.com/aseprite/aseprite/issues),
[bug](https://community.aseprite.org/c/bugs),
or [feature](https://community.aseprite.org/c/features)),
post a comment asking if somebody is already working on that,
in that way you can avoid start programming in something that is already
done for the next release or which someone else is working on.
2013-11-23 19:01:49 +00:00
And always remember to take a look at our
[roadmap](http://www.aseprite.org/roadmap/).