From 815d3767da1ddf74f7740e65279b8ed94e930fb3 Mon Sep 17 00:00:00 2001 From: Bastien Date: Sun, 13 Sep 2020 08:16:51 +0200 Subject: [PATCH] Some updates to how to contribute and Woof --- org-contribute.org | 34 +++++++++++++++++++--------------- org-faq.org | 8 ++++---- org-mailing-list.org | 24 ++++++++++++++++++++---- 3 files changed, 43 insertions(+), 23 deletions(-) diff --git a/org-contribute.org b/org-contribute.org index 48313549..cf71d71d 100644 --- a/org-contribute.org +++ b/org-contribute.org @@ -21,12 +21,18 @@ Every contribution to Org is very welcome. -- You can *fix bugs*: check [[https://updates.orgmode.org/][updates.orgmode.org]] for confirmed bugs. +- You can [[file:donate.org][make a donation]]. + +- You can check our *requests for help* on [[https://updates.orgmode.org/][updates.orgmode.org]] and + subscribe to [[https://updates.orgmode.org/feed/help][this RSS feed]]. + +- You can *fix bugs* referenced on [[https://updates.orgmode.org/][updates.orgmode.org]] and subscribe to + [[https://updates.orgmode.org/feed/bugs][this RSS feed]]. - You can try to *reproduce bugs*: subscribe to [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][Org's mailing list]] and - monitor new bugs. For new ones, try to reproduce them. If you can + monitor new unreferenced bugs. Try to reproduce them. If you can reproduce a bug, reply to the OP and add =X-Woof-Bug: confirmed= to - your mail headers, the bug will then pop up on [[https://updates.orgmode.org/][updates.orgmode.org]]. + your mail headers, the bug will then pop up on [[https://updates.orgmode.org/][updates.orgmode.org]]. - You can *send bug reports*. Before sending a bug report, make sure you have read the [[https://orgmode.org/org.html#Feedback][Feedback]] section of Org's manual or this other @@ -37,28 +43,26 @@ Every contribution to Org is very welcome. submitting patches]] section for details. You can run =make test= to check that your patch does not introduce new bugs. - If your patch is against a file that is part of Emacs, then your - total contribution (all patches you submit) should change /less than - 15 lines/ (See the [[http://git.savannah.gnu.org/cgit/emacs.git/tree/CONTRIBUTE][CONTRIBUTE file in GNU Emacs]].) If you contribute - more, you have to assign the copyright of your contribution to the - Free Software Foundation (see below). + If your patch is against an Org file that is part of Emacs, then + your total contribution (all patches you submit) should change /less + than 15 lines/ (See the [[http://git.savannah.gnu.org/cgit/emacs.git/tree/CONTRIBUTE][CONTRIBUTE file in GNU Emacs]].) If you + contribute more, you have to assign the copyright of your + contribution to the Free Software Foundation (see below). - You can *contribute to Worg*. Learn what Worg is [[file:worg-about.org][about]] and how to contribute to it [[file:worg-git.org][through git]]. - You can *share ideas and feature requests*. Org is already mature, but new ideas keep popping up. If you want to request a feature, - first dig into the mailing list to find similar proposals. If you + first dig into [[file:org-mailing-list.org][the mailing list]] to find similar proposals. If you cannot find any, subscribe to [[file:org-mailing-list.org][the mailing list]], read it for a while, then make your proposal. Formulate it as detailed as possible, if possible with examples. -- You can *write add-ons*. - - The best way is to submit your code to [[file:org-mailing-list.org][the mailing list]] to discuss - it with people. - - If you decide to sign the [[*Copyright issues when contributing to Emacs Org mode][assignment contract with the FSF]], we - might include your contribution in the distribution, and then in - GNU Emacs. +- You can *write add-ons*. The best way is to submit your code to [[file:org-mailing-list.org][the + mailing list]] to discuss it with people. If you decide to sign the + [[*Copyright issues when contributing to Emacs Org mode][assignment contract with the FSF]], we might include your contribution + in the distribution, and then in GNU Emacs. * For Org developers :PROPERTIES: diff --git a/org-faq.org b/org-faq.org index 8332cbc3..e1b68de7 100644 --- a/org-faq.org +++ b/org-faq.org @@ -228,7 +228,7 @@ Please check [[file:org-papers.org][the Org papers page]] for more references re 1. Make sure you are running [[#updating-org][the latest version of Org-mode]]. - 2. Read [[https://orgmode.org/manual/Feedback.html][this section]] of the manual. + 2. Read [[https://orgmode.org/manual/Feedback.html][the Feedback section]] of the manual. 3. Provide a minimal example that duplicates the bug. @@ -291,9 +291,9 @@ Please check [[file:org-papers.org][the Org papers page]] for more references re #+index: Gmane The org-mode mailing list is available via nntp at - =news.gmane.io/gmane.emacs.orgmode=. Many participants in the list - prefer read the list in a newsreader, such as Gnus, instead of - receiving emails. If you choose to read the list via nntp, you can + =news.gmane.io/gmane.emacs.orgmode=. Many participants in the list + prefer to read the list in a newsreader, such as Gnus, instead of + receiving emails. If you choose to read the list via nntp, you can still [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][subscribe]] to the list and then opt not to receive any emails on the mailman settings page (see the "Mail Delivery" setting). diff --git a/org-mailing-list.org b/org-mailing-list.org index 340121be..f8dc98af 100644 --- a/org-mailing-list.org +++ b/org-mailing-list.org @@ -15,15 +15,16 @@ [[file:index.org][{Back to Worg's index}]] The Org mailing list is an English language forum for discussing Org. + It is used by the diverse community of Org developers, maintainers, contributors, experienced users, and new and prospective users both -for discussion and as a repository of information. It was established +for discussion and as a repository of information. It was established by the creator of Org-mode, Carsten Dominik, who enjoys the different perspectives and range of interests expressed there. The list is less formal and more diverse than a site like -[[http://stackoverflow.com/tags/org-mode/info][stackoverflow]], which has an org-mode section. Subscribers' messages to -the list aren't moderated and there is no formal mechanism to rate +[[http://stackoverflow.com/tags/org-mode/info][stackoverflow]], which has an org-mode section. Subscribers' messages +to the list aren't moderated and there is no formal mechanism to rate questions, answers, or reputations. List etiquette encourages posters to be precise, concise, and @@ -37,6 +38,21 @@ cut away the rest. The [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][Org mailing list]] is very active. You can browse it at http://lists.gnu.org/archive/html/emacs-orgmode/. +* The list and [[https://updates.orgmode.org/][updates.orgmode.org]] + +[[https://updates.orgmode.org/][updates.orgmode.org]] makes it easier to keep track of important Org +announcements such as new releases, confirmed bugs, help requests and +user-significant changes. + +The information on this page only comes from interacting with the Org +mailing list. + +To confirm a bug, just add =X-Woof-Bug: confirmed= in the headers of +your reply to the list. + +See https://github.com/bzg/woof#usage for detailed usage explanations +and [[https://orgmode.org/list/87y2p6ltlg.fsf@bzg.fr/][Woof announcement]] on the list. + * What to do before posting a question Please see the following FAQs: @@ -46,7 +62,7 @@ Please see the following FAQs: - [[file:org-faq.org::#ml-subscription-and-gmane][I read the mailing list through gmane. Should I subscribe?]] - [[file:org-faq.org::#bug-reporting][I think my Org-mode is broken! How do I report a bug?]] -* Statistics (as of sept. 19th 2010) +* COMMENT Statistics (as of sept. 19th 2010) ** Scope and method -- 2.11.4.GIT