Re: contributing to Emacs

[Eli Zaretskii]

> From: Konstantin Kharlamov <hi-angel@yandex.ru>
> Cc: arne_bab@web.de, ams@gnu.org, luangruo@yahoo.com, emacs-devel@gnu.org
> Date: Sun, 18 Jun 2023 14:54:11 +0300
> 
> > Separating them will be even more confusing: people will read one, but
> > not the other, and tell us they didn't find something.
> 
> Not necessarily. Let me reiterate: the chapter "Sending Patches" has two
> different things: "How to send patches" and "What should patch contain". It is
> *already* the case, all I am suggesting is simply divide them with a title
> (well, maybe a little bit of refactoring may be needed to make sure the two
> parts has only relevant texts).

A new contributor needs to know both.

> Why would a person complain they didn't find text about patch content in 
> section
> "how to send patches" if it belongs to the section right next to it "What 
> should
> a patch contain".

Because in an Info reader you don't necessarily see the "section right
next to the current one".

> If these two sections are on the same page, a person would see them both,
> especially so given the "how to send patches" section would be very short.

You assume the contributors read a paper copy or a PDF version of the
manual?