~bzg/orgweb

8e204cf0056211b463a6b59253c91879481a038b — Bastien 2 months ago ff5a73a
Remove contribute.org and point to worg/org-contribute.html
6 files changed, 5 insertions(+), 139 deletions(-)

D contribute.org
M elpa.org
M fr/index.org
M index.org
M ja/index.org
M resources/preamble.html
D contribute.org => contribute.org +0 -134
@@ 1,134 0,0 @@
#+TITLE: Contribute | Org mode
#+setupfile: setup.org
#+description: Org: an Emacs Mode for Notes, Planning and Authoring
#+include: "./resources/preamble.html" export html
#+include: "./resources/normal-outline-3.html" export html

* Contribute
  :PROPERTIES:
  :CUSTOM_ID: contribute
  :END:

Org mode is [[file:manual/History-and-Acknowledgments.html][built on the efforts of enthusiastic volunteers]].  The two
best ways to contribute to Org are with time or money.  Donations
support Org's primary maintainer Bastien Guerry.

#+begin_export html
<div class="banner"><p style="margin:0 0.5em">
<a href="https://liberapay.com/bzg" title="Donations always help" style="color: #c7a416; display: inline-block">
<img class="inline" src="/resources/img/external/librepay.svg"/> Liberapay</a>
<a href="https://github.com/sponsors/bzg" title="Donations always help" style="color: #222; display: inline-block">
<img class="inline" src="/resources/img/external/github.svg"/> GitHub</a>
<a href="https://www.paypal.com/paypalme/bzg/10" title="Donations always help" style="color: #253b80; display: inline-block">
<img class="inline" src="/resources/img/external/paypal.svg"/> PayPal</a>
</p></div>
#+end_export

You can also support Org with your time, no matter your level of
experience.

#+begin_export html
<div class="banner"><p style="margin:0 0.5em">
<a href="https://git.savannah.gnu.org/cgit/emacs/org-mode.git/" style="color: #661a13; display: inline-block">The Org Codebase</a>
</p></div>
#+end_export

The fastest way to get involved is by [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][subscribing to the mailing list]].
You can also always get in touch via [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]] to help
move the project forward.

# FIXME this section needs links, e.g. to instructions for running tests

- Very little experience :: Give [[file:manual/Feedback.html][feedback]] about your experience with org.
- A dash of experience :: Help improve the documentation.
- Some experience :: Help test patches, track down bugs.
- Moderate experience :: Submit bug-fixes, improve features.

Whatever your contribution, it is appreciated 😀.

* Copyright assignment
  :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 [[https://www.fsf.org/][Free
Software Foundation]] (FSF).

If you want to contribute more than 15 lines of code to Org mode you
will [[https://www.gnu.org/licenses/why-assign.html][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 [[https://orgmode.org/request-assign-future.txt][this form]] and email it to [[mailto:assign@gnu.org][assign@gnu.org]].

* Submitting patches
  :PROPERTIES:
  :CUSTOM_ID: patches
  :END:

** Suggested workflow
#+BEGIN_SRC shell
~$ 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="emacs-orgmode@gnu.org" HEAD^
#+END_SRC

** Coding conventions

Org is part of Emacs, so any contribution should follow the [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Coding-Conventions.html][GNU Emacs
Lisp coding conventions]] described in Emacs manual.

** Commit messages

Commit messages also need to be structured according to Emacs
conventions.

#+BEGIN_EXAMPLE
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.
#+END_EXAMPLE

More formally,

1. The first line should include the file/feature affected, followed
   by a colon and an short description of the overall change (this
   description starts with an uppercase letter and does not end with a
   dot.)
2. The second line should be left blank
3. Start on the third line there should be a ChangeLog entry for each
   file changed, as seen in the example above
   - Quote variables and function names like ~`this'~
   - Separate sentences with *two* spaces
   - Use active voice instead of passive voice
   - Try to be terse
4. The line after the final ChangeLog entry should be left blank
5. Optionally this may be followed by any supplementary information
   explaining the patch
6. If the patch is from a contributor /without/ FSF assignment, it can
   be accepted as long as it contains no more than 15 lines.  In this
   case add the =TINYCHANGE= cookie (anywhere in the message)

** Sending patches

You can use ~git format-patch~ or ~git diff~ to generate the patch files
and then include them in an email to [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]] describing
what you've done.  If you have configured git to use [[https://git-send-email.io/][send-email]], then
you can use that.  If you are sending the patch manually, please add
the phrase =[PATCH]= to the beginning of the =Subject:= line of your
e-mail, your submission will then be tracked on [[https://updates.orgmode.org][updates.orgmode.org]].

If your mail has not appeared on [[https://list.orgmode.org/][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 [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][subscribing]] to the mailing list.

M elpa.org => elpa.org +1 -1
@@ 69,4 69,4 @@ See the [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.htm
  :CUSTOM_ID: questions
  :END:

Report any problem and ask any question on the Org mode [[https://orgmode.org/contribute.html#mailing-list][mailing list]].
Report any problem and ask any question on the Org mode [[https://orgmode.org/worg/org-mailing-list.html][mailing list]].

M fr/index.org => fr/index.org +1 -1
@@ 79,7 79,7 @@ Qu'est-ce que vous attendez ?
Commencez à utiliser Org. Vous ne pourrez plus vous arrêter.
@@html:</a>@@
** Contribuer
@@html:<a href="contribute.html">@@
@@html:<a href="worg/org-contribute.html">@@
[[file:../resources/img/contribute.svg]]

Oui oui, faites le.

M index.org => index.org +1 -1
@@ 84,7 84,7 @@
@@html:</a>@@

** Contribute
@@html:<a href="contribute.html">@@
@@html:<a href="worg/org-contribute.html">@@
#+attr_html: :alt Git branch symbol :title Yes. Do this.
[[file:resources/img/contribute.svg]]


M ja/index.org => ja/index.org +1 -1
@@ 77,7 77,7 @@
@@html:</a>@@

** コントリビュート
@@html:<a href="../contribute.html">@@
@@html:<a href="../worg/org-contribute.html">@@
#+attr_html: :alt Git branch symbol :title 皆さんの貢献で支えられています。
[[file:../resources/img/contribute.svg]]


M resources/preamble.html => resources/preamble.html +1 -1
@@ 17,5 17,5 @@
    <a href="https://orgmode.org/org.html#Installation">Install</a>
    <a href="/manual">Manual</a>
    <a href="/worg">Worg</a>
    <a href="/contribute.html">Contribute</a>
    <a href="/worg/org-contribute.html">Contribute</a>
</nav>