| 1 | |
| 2 | [[PageOutline]] |
| 3 | |
| 4 | = How to contribute to (F)CKEditor = |
| 5 | |
| 6 | There are several ways you can help its development, here's the guidelines: |
| 7 | |
| 8 | * By [#Reportingbugs reporting bugs]. |
| 9 | * By [#Providingpatches submitting patches]. |
| 10 | * By [#Translating translating] |
| 11 | * By [#Documentation writing] documentation. |
| 12 | * By writing [http://docs.cksource.com/FCKeditor_3.x/Design_and_Architecture/Plugin_Based plugins] around (F)CKEditor. |
| 13 | * By '''helping''' others through our [http://cksource.com/forums/viewforum.php?f=10 support board] on forum. |
| 14 | * By '''discussing''' on how (F)CKEditor could be improved by posting on the [http://cksource.com/forums/viewforum.php?f=11 development board] on forum. |
| 15 | |
| 16 | == Reporting bugs == |
| 17 | Described [wiki:Bugs here]. |
| 18 | == Providing patches == |
| 19 | |
| 20 | We do love patches, but several rules must be followed to may them been efficiently accepted: |
| 21 | |
| 22 | === Providing patches === |
| 23 | Inside a patch, following [wiki:CodingStyle coding standards] is one of the easiest way for everybody to understand everybody's code and require no housekeeping. |
| 24 | |
| 25 | Patch files are the official way to present us your contirubtion, it should always be in the [http://en.wikipedia.org/wiki/Diff unified diff] format and apply to the conventoin described [wiki:TicketLifeCycle#ProposingPatches here]. |
| 26 | |
| 27 | Please don't put the patch in the ticket description or comment, unless it's a single line patch. |
| 28 | |
| 29 | The patch should dedicate to code required to fix a problem or add a feature, may include relevant test case(s) to verify the result, and that should be all of it, avoid trying to address other irrelevant problems in it. |
| 30 | |
| 31 | If the code associated with a patch adds a new feature, or modifies behavior of an existing feature, the patch should also contain documentation. |
| 32 | |
| 33 | To make sure the quality of project, we only open repository commit permission for core developers, as a community contributors, it's enough to add ''''HasPatch'''' to the '''keyword''' ticket field, and let the core developers take care of the integration it into the [wiki:TicketLifeCycle workflow]. |
| 34 | Depending on the review result, your patch may finally get accepted and get commited, or you may choose to come with a new patch in case the review fails. |
| 35 | |
| 36 | === Translating === |
| 37 | |
| 38 | Our language files are managed as other source files, you can find them in the [http://dev.fckeditor.net/browser/CKEditor/trunk/_source/lang lang] directory. |
| 39 | |
| 40 | === Documentation === |
| 41 | |
| 42 | Our documentation is composed in English, you're welcomed to write in the project's documentation site with an [http://docs.cksource.com/index.php?title=Special:UserLogin&type=signup&returnto=CKEditor_3.x/Developers_Guide account]. |