:PROPERTIES: :CUSTOM_ID: contribute :END:
Org mode is . The two best ways to contribute to Org are with time or money. Donations support Org's primary maintainer Bastien Guerry.
You can also support Org with your time, no matter your level of experience.
Whatever your contribution, it is appreciated 😀.
:PROPERTIES: :CUSTOM_ID: copyright :END:
Org mode has a substantial code base composed of many files, most of which are distributed as part of GNU Emacs.
These files make up the Org core and are copyrighted by the Free Software Foundation (FSF).
If you want to contribute more than 15 lines of code to Org mode you will need to assign the copyright for your contributions to the FSF so that they can be included in GNU Emacs. To start the copyright assignment process fill out this form and email it to email@example.com.
:PROPERTIES: :CUSTOM_ID: patches :END:
~$ git pull ~$ git checkout -b my-changes # make some changes ~$ git commit -a -m "Definitely following the commit conventions" # repeat a few times, as appropriate ~$ git format-patch master # optional, see: https://git-send-email.io/ ~$ git send-email --to="firstname.lastname@example.org" HEAD^
Org is part of Emacs, so any contribution should follow the GNU Emacs Lisp coding conventions described in Emacs manual.
Commit messages also need to be structured according to Emacs conventions.
main file/feature: Overall change summary ,* file-changed.el (function-changed, another-function): Description of the change implemented, reference any relevant `other-functions' or `variables' here. (another-changed-function): Change something. Use active voice, and avoid passive forms. Please write in full sentences.
git diff or
git format-patch to generate the patch files and then
include them in an email to email@example.com describing what
you've done. If you have configured git to use send-email, then you
can use that.
If your mail has not appeared on the list after waiting at least 15 minutes, it may have been flagged as spam by the robot email overlords. If this happens, you should be able to get the email to go through by subscribing to the mailing list.