Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
43 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Contributing to Annotation Command Framework | ||
## The Golden Rule: Keep it small, work incrementally! | ||
|
||
Unlike most other projects that won't take your PR every possible color of kitten can be considered, ACF prefers that you keep your PR's small, and work incrementally. | ||
|
||
Try to complete work to a small enough unit that it is mergeable. | ||
|
||
There are plenty of large systems in ACF that has been built in small units. contributors are welcome to help build the | ||
larger systems that power ACF by contributing small units of the feature. | ||
|
||
The larger a PR becomes, the more time it takes to review, and the bigger risk of change comes. Keep it simple! | ||
|
||
Leave code in a package-private access level and then it will be promoted to public once we are ready to open it up for use. | ||
|
||
## Keep major formatting and/or docs changes to existing code as completely separate PR's, but again, incremental | ||
Please keep formatting improvements and documentation to existing code (meaning, code that is not part of your own feature API) | ||
as standalone PR's. In other words, don't submit a PR that changes behavior or adds features, but also changes 10 other files | ||
unrelated to the PR just to improve things. | ||
|
||
Keep them separate, so they can be reviewed and pulled separately. | ||
|
||
Additionally, keep them small and incremental! | ||
|
||
## Discuss with Aikar before starting any major behavior change / annotation addition | ||
Before you go spending a lot of time on a PR that isn't resolving an issue that Aikar filed, please consult with Aikar | ||
on Discord or IRC about the idea, to ensure it fits well with the projects goals. | ||
|
||
ACF is moving to a very extensible goal for the 1.0.0 release, with powerful custom annotation support. | ||
|
||
I want to avoid adding new stuff that will then be quickly deprecated when the more preferred approach comes out. | ||
|
||
## Translations | ||
New messaging should add respective english Message Properties. if you know some of the other languages already translated, | ||
feel free to go ahead and add the translations for your new feature too. English is the only required language for a new feature. | ||
|
||
Translators, I am leaving it up to the community to review and vet translations. If you see some bad translations, please | ||
submit a PR to correct them! | ||
|
||
Additionally, if you help translate messages for ACF, please follow the repo and keep up with new commits and watch for | ||
new messages, to keep the non english languages caught up. | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
MIT License | ||
The MIT License (MIT) | ||
|
||
Copyright (c) 2015-2018 Daniel Ennis and Contributors | ||
|
||
|