Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien Guerry]

Ihor Radchenko  writes:

> I notice that the old https://orgmode.org/contribute.html is still lying
> around. Should we remove it? Or put a redirect?

I've put a redirect to https://orgmode.org/worg/org-contribute.html
and removed the old page.

Thanks!

-- 
 Bastien Guerry

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Ihor Radchenko]

Bastien  writes:

>> in the absence of any other volunteer, i'd be happy to produce a merge
>> for review.  (though it might take a few weeks.)
>
> thanks a lot for volunteering, but I did the merge a few days ago.

I notice that the old https://orgmode.org/contribute.html is still lying
around. Should we remove it? Or put a redirect?

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at .
Support Org development at ,
or support my work at 

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Greg Minshall]

Bastien,

> I added you, you can now clone g...@git.sr.ht:~bzg/worg 
> and push commits.

thanks.

cheers, Greg

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Greg Minshall  writes:

> thanks.  i'm "minshall" there, too.

I added you, you can now clone g...@git.sr.ht:~bzg/worg 
and push commits.

-- 
 Bastien

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Greg Minshall]

Bastien,

> Applied, thanks a lot!  Let me know if you have a user on git.sr.ht, I
> can add you as a regular committer on https://git.sr.ht/~bzg/worg

thanks.  i'm "minshall" there, too.

cheers, Greg

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Hi Greg,

Greg Minshall  writes:

> sure.  some comments and a patch (and, without the nice css, the .html
> file it generates, just for ease of reviewing).

Applied, thanks a lot!  Let me know if you have a user on git.sr.ht, I
can add you as a regular committer on https://git.sr.ht/~bzg/worg

All best,

-- 
 Bastien

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Greg Minshall]

Bastien,

> thanks a lot for volunteering, but I did the merge a few days ago.

great!

> Perhaps you can still carefully proofread
> https://orgmode.org/worg/org-contribute.html and enhance it?

sure.  some comments and a patch (and, without the nice css, the .html
file it generates, just for ease of reviewing).

i was thinking of (more or less) sorting the "ways to contribute" in
terms of difficulty/level of expertise required.  the below patch tries
to do this (ysomv -- your sort order may vary).

other than that, i did a bit of editing, added a few links and
footnotes, etc.

nit: i don't know how widespread this is, or whether it matters when someone
is looking on worg about how to contribute, but my setup (arch linux,
qutebrowser) doesn't include
: "C-x 8 RET 1f984" or "C-x 8 RET UNICORN FACE"

hope it's of use.

cheers, Greg

>From 8cf98908c94c2f8bbc0abcfc5cf948dc0a0820e3 Mon Sep 17 00:00:00 2001
From: Greg Minshall 
Date: Fri, 8 Oct 2021 15:08:17 +0300
Subject: [PATCH 2/2] org-contribute.org: Edit and re-organize slightly

---
 org-contribute.org | 90 --
 1 file changed, 48 insertions(+), 42 deletions(-)

diff --git a/org-contribute.org b/org-contribute.org
index a21c5223..d684ccdb 100644
--- a/org-contribute.org
+++ b/org-contribute.org
@@ -19,48 +19,54 @@
 
 The Org codebase is large, and contributing can be daunting at first,
 but don't hesitate to call for directions on [[file:org-mailing-list.org][the mailing list]].  If you
-are willing to help, there is plenty of low-hanging fruits for you and
+are willing to help, there is plenty of low-hanging fruit for you, and
 the community will welcome your contribution.
 
-: When contributing, always beware of the maintenance burden:
-: are you alleviating it or are you adding to it?
+: When contributing, always keep the maintenance burden in mind:
+: are you alleviating it, or are you adding to it?
 
 * Ways to contribute 濾
 :PROPERTIES:
 :CUSTOM_ID: types-of-contributions
 :END:
 
-- *Maintain an Org file*: If a file in the git repository does not have
-  a maintainer, and you want to help by maintaining it, please read
-  more on [[file:org-maintenance.org][how Org is maintained]] and let us know by sending an email to
-  [[file:org-mailing-list.org][the mailing list]].
+** Ways that do not involve programming
 
-- *Check the [[https://updates.orgmode.org/#help][requests for help]]*: If you want to help with one of these
-  tasks, say so on the list.
-
-- *Check the [[https://updates.orgmode.org/#bugs][list of confirmed bugs]]*: Even if you just provide more
-  information or ideas on how to fix them, this helps.
+- *Send bug reports*.  Before sending a bug report, make sure you read
+  the section of the manual on how to provide useful [[https://orgmode.org/org.html#Feedback][feedback]] or this
+  other great text: [[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html][How to Send Bug Reports Effectively]].
 
 - *Try to reproduce bugs*: That's always very helpful.  Do subscribe to
   [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][Org's mailing list]] and monitor new unreferenced bugs.  Try to
   reproduce them.  If you can reproduce a bug, reply to the original
-  poster and add =X-Woof-Bug: confirmed= to your mail headers, and the
+  poster and add [[https://github.com/bzg/woof][=X-Woof-Bug: confirmed=]] to your mail headers, and the
   bug will then be shown on [[https://updates.orgmode.org/#bugs][updates.orgmode.org]].
 
 - *Help other users by replying to their questions* [[file:org-mailing-list.org][on the mailing list]]
   or on [[file:org-web-social.org][other web places]].
 
-- *Send bug reports*.  Before sending a bug report, make sure you read
-  the section of the manual on how to provide useful [[https://orgmode.org/org.html#Feedback][feedback]] or this
-  other great text: [[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html][How to Send Bug Reports Effectively]].
-
-- *Submit patches* to the mailing list.  See how to format [[#first-patch][your first
-  patch]] and [[#patches][details on how to submit it]].
-
 - *Contribute to Worg*.  Worg is collaborative documentation made of Org
   files.  It's very easy to contribute to it.  Learn more [[file:worg-about.org][about Worg]]
   and [[file:worg-about.org::*How to use git for Worg][how to contribute]].
 
+- *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 [[file:org-mailing-list.org][the mailing list]] to find similar proposals.  If you cannot find
+  any, subscribe to the list, read it for a while, then make your
+  proposal.  Formulate it with as much detail as possible, especially
+  with examples.
+
+** Ways that involve programming
+
+- *Check the [[https://updates.orgmode.org/#help][requests for help]]*: If you want to help with one of these
+  tasks, say so on the list.
+
+- *Check the 

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Hi Bhavin,

Bhavin Gandhi  writes:

> I second the mention of something like "Confirmed" instead of email
> headers. I recently started reading Org mode list, reproducing bug
> reports, and using email headers is something I haven't managed to do yet
> (pending as I'm yet to set up some email client). Reading Woof!
> documentation made it clear about other ways than email headers
> though.

I added this section, with a small introduction to the current way of 
tracking bugs and patches:

https://orgmode.org/worg/org-maintenance.html#orgc84c8f5

If you want to improve it (shorter is better), please go ahead!

-- 
 Bastien

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bhavin Gandhi]

Hi Ihor and Bastien,

On Thu, 7 Oct 2021 at 21:08, Bastien  wrote:
> Ihor Radchenko  writes:
>
> > We may want to put reference to Woof docs. Not all users are even able
> > to add headers to emails. Or we can simply recommend using word
> > "^Confirmed" in emails.

I second the mention of something like "Confirmed" instead of email
headers. I recently started reading Org mode list, reproducing bug
reports, and using email headers is something I haven't managed to do yet
(pending as I'm yet to set up some email client). Reading Woof!
documentation made it clear about other ways than email headers though.

> Yes - this needs to be better documented.  I'm currently working on
> the next version of Woof!, it will comes with many enhancements, I'll
> reference to the new documentation when I make the switch.
>

Awesome! Thanks.

-- 
Regards,
Bhavin Gandhi (bhavin192) | https://geeksocket.in

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Hi Ihor,

Ihor Radchenko  writes:

> Some comments:
>
>>> If you can reproduce a bug, reply to the original poster and add
>>> X-Woof-Bug: confirmed to your mail headers, and the bug will then be
>>> shown on updates.orgmode.org.
>
> We may want to put reference to Woof docs. Not all users are even able
> to add headers to emails. Or we can simply recommend using word
> "^Confirmed" in emails.

Yes - this needs to be better documented.  I'm currently working on
the next version of Woof!, it will comes with many enhancements, I'll
reference to the new documentation when I make the switch.

>> Maintain an Org file: If a file in the git repository does not have a
>> maintainer, and you want to help by maintaining it, please let us know
>> by sending an email to the mailing list.
>
> Also, it may be a good idea to clarify what maintainer duties are.
> People are asking:
> https://list.orgmode.org/m2pmsi6vob@gmail.com/T/#you

I added a few lines, I hope it answers some of the main questions.

Thanks!

-- 
 Bastien

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Ihor Radchenko]

Bastien  writes:

> Perhaps you can still carefully proofread
> https://orgmode.org/worg/org-contribute.html and enhance it?

Some comments:

>> If you can reproduce a bug, reply to the original poster and add
>> X-Woof-Bug: confirmed to your mail headers, and the bug will then be
>> shown on updates.orgmode.org.

We may want to put reference to Woof docs. Not all users are even able
to add headers to emails. Or we can simply recommend using word
"^Confirmed" in emails.

> Maintain an Org file: If a file in the git repository does not have a
> maintainer, and you want to help by maintaining it, please let us know
> by sending an email to the mailing list.

Also, it may be a good idea to clarify what maintainer duties are.
People are asking:
https://list.orgmode.org/m2pmsi6vob@gmail.com/T/#you

Best,
Ihor

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Hi Greg,

Greg Minshall  writes:

> in the absence of any other volunteer, i'd be happy to produce a merge
> for review.  (though it might take a few weeks.)

thanks a lot for volunteering, but I did the merge a few days ago.

Perhaps you can still carefully proofread
https://orgmode.org/worg/org-contribute.html and enhance it?

Thanks a lot,

-- 
 Bastien

Re: Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Greg Minshall]

hi, Bastien,

in the absence of any other volunteer, i'd be happy to produce a merge
for review.  (though it might take a few weeks.)

cheers, Greg

> as the subject says: 
> 
> https://orgmode.org/contribute.html is very straightforward and
> https://orgmode.org/worg/org-contribute.html is very complete.
> 
> I think we should merge both pages into worg/org-contribute.org,
> the page that we recommand users to read in general.
> 
> The page would start with simple "calls to action" and progress
> toward more informative sections.
> 
> It's a delicate balance to have -- but having two pages for the
> same purpose isn't very good today.
> 
> Anyone?
> 
> -- 
>  Bastien
> 

Someone to help merging orgmode.org/contribute.html and orgmode.org/worg/org-contribute.html ?

[Bastien]

Hi all,

as the subject says: 

https://orgmode.org/contribute.html is very straightforward and
https://orgmode.org/worg/org-contribute.html is very complete.

I think we should merge both pages into worg/org-contribute.org,
the page that we recommand users to read in general.

The page would start with simple "calls to action" and progress
toward more informative sections.

It's a delicate balance to have -- but having two pages for the
same purpose isn't very good today.

Anyone?

-- 
 Bastien