|
@@ -5,32 +5,30 @@ development.
|
|
|
|
|
|
* Org maintenance
|
|
|
|
|
|
-Org maintenance is explained on Worg: see [[https://orgmode.org/worg/org-maintenance.html][org-maintenance]].
|
|
|
+Org maintenance is detailed on Worg: see [[https://orgmode.org/worg/org-maintenance.html][org-maintenance]].
|
|
|
|
|
|
* Main contribution rules
|
|
|
|
|
|
-1. The master git repository is hosted publicly at [[https://orgmode.org][orgmode.org]].
|
|
|
+1. The master git repository is hosted publicly on [[https://savannah.gnu.org][savannah.gnu.org]].
|
|
|
|
|
|
- Anyone can get a clone of the current repository like this:
|
|
|
+ : git clone https://git.savannah.gnu.org/git/emacs/org-mode.git
|
|
|
|
|
|
- : git clone https://code.orgmode.org/bzg/org-mode.git
|
|
|
+ This is sufficient to start hacking and to produce patches that can
|
|
|
+ easily and consistently be applied to the main repository.
|
|
|
|
|
|
- Having a clone is sufficient to start hacking and to produce
|
|
|
- patches that can easily and consistently be applied to the main
|
|
|
- repository.
|
|
|
-
|
|
|
-2. People who are interested in participating to the Org mode
|
|
|
- development can do so by sending patches to the mailing list:
|
|
|
+2. People who want to participate to the Org mode development can send
|
|
|
+ patches to this address:
|
|
|
|
|
|
: emacs-orgmode@gnu.org
|
|
|
|
|
|
-3. An interested developer can also request push access to the
|
|
|
- repository by sending an email to the maintainer to request an
|
|
|
- account on code.orgmode.org.
|
|
|
-
|
|
|
- After you have been added as a user with push privileges:
|
|
|
+3. If you are a regular contributor, you can request push access to
|
|
|
+ the repository by creating an account on [[https://savannah.gnu.org/account/register.php][savannah.gnu.org]] and by
|
|
|
+ [[https://savannah.gnu.org/git/?group=emacs][joining the Emacs group]].
|
|
|
+
|
|
|
+ After you have been added as a user with push privileges, you can
|
|
|
+ clone the repository like this:
|
|
|
|
|
|
- : git clone git@code.orgmode.org:bzg/org-mode.git
|
|
|
+ : git clone git://git.savannah.gnu.org/emacs/org-mode.git
|
|
|
|
|
|
By requesting push access, you acknowledge that you have read and
|
|
|
agreed with the following rules:
|
|
@@ -42,14 +40,13 @@ Org maintenance is explained on Worg: see [[https://orgmode.org/worg/org-mainten
|
|
|
applies are:
|
|
|
|
|
|
- all *.el files in the lisp directory of the repository
|
|
|
- - org.texi, orgcard.tex in the doc directory
|
|
|
- - the corresponding ChangeLog files
|
|
|
+ - org.texi, orgcard.tex in the doc/ directory
|
|
|
|
|
|
- Before making any significant changes, please explain and discuss
|
|
|
- them on the mailing list [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]].
|
|
|
+ them on the mailing list [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]].
|
|
|
|
|
|
This does obviously not apply to people who are maintaining their
|
|
|
- own contributions to Org mode. Please, just use the new mechanism
|
|
|
+ own contributions to Org mode. Please just use the new mechanism
|
|
|
to make sure all changes end up in the right place.
|
|
|
|
|
|
We value a nice tone in our discussions: please check and respect
|
|
@@ -60,9 +57,8 @@ Org maintenance is explained on Worg: see [[https://orgmode.org/worg/org-mainten
|
|
|
`CONTRIBUTE' file in the main Emacs repository.
|
|
|
|
|
|
- Among other things, Org mode is widely appreciated because of its
|
|
|
- simplicity, cleanness and consistency. We should try hard to
|
|
|
- preserve this and ask everyone to keep this in mind when
|
|
|
- proposing changes.
|
|
|
+ simplicity, cleanness and consistency. We should try to preserve
|
|
|
+ them and ask everyone to keep this in mind when posting changes.
|
|
|
|
|
|
See [[https://orgmode.org/worg/org-contribute.html][worg/org-contribute]] for more guidance on how to contribute
|
|
|
effectively.
|