From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: contributing to Emacs Date: Sun, 18 Jun 2023 15:18:50 +0300 Message-ID: <83ttv57yl1.fsf@gnu.org> References: <83v8fnslfz.fsf@gnu.org> <87v8fnh1h2.fsf@web.de> <83mt0zs9rc.fsf@gnu.org> <0a968a4e1b267c0f15dd237e6ea12a709fc06d5e.camel@yandex.ru> <838rcisj7o.fsf@gnu.org> <6537fa5fa5c1fe8437ed99ee0988e35895f5a54b.camel@yandex.ru> <8423a35750d8d8e0437c7708f6b4d0bbdfdb7fe0.camel@yandex.ru> <87o7ldf7ky.fsf@web.de> <8cc19084ab18d0adb0f2cee4af14aa1b1d914a83.camel@yandex.ru> <83sfapnl57.fsf@gnu.org> <83pm5tnk78.fsf@gnu.org> <73cbe80096cd97728fcdaccf9f9badeea606570b.camel@yandex.ru> <83mt0xnjl6.fsf@gnu.org> <6e122f89169630efcde23f23f8b799924c2eb3c8.camel@yandex.ru> <83jzw1nihu.fsf@gnu.org> <95994d8393a2abcc053936da0a68b37cb51b3ff3.camel@yandex.ru> <83fs6pngyu.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11221"; mail-complaints-to="usenet@ciao.gmane.io" Cc: arne_bab@web.de, ams@gnu.org, luangruo@yahoo.com, emacs-devel@gnu.org To: Konstantin Kharlamov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 18 14:19:25 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qArNM-0002h9-Qd for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Jun 2023 14:19:24 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qArMp-00040a-DG; Sun, 18 Jun 2023 08:18:51 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qArMn-00040B-V0 for emacs-devel@gnu.org; Sun, 18 Jun 2023 08:18:49 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qArMn-0003u3-Br; Sun, 18 Jun 2023 08:18:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=XQni3PWSnTKifqibkjKwgvwNARR4I7E20o4z6ghSOl0=; b=ThJdcQZqag/G ksf8o+kiORI/LjhhXEnnFOFSxGHpaGsCRBnE6Aew6toCrvmrEbnfCy+0aS/uebvHSKOi0XHQ72/RZ ekZ8kMXDbp/j2RQfzyh9hCAYP1lHwjT2e7qFEtqR9oggv6zzjIMMhqJvGgsyKWmX0mUDwd9ubJIWL gnsON3z1v5Lwwaw9NvaZK+o5WoK8Zyw2hjoyJM3MeXvyRIwdM4bIl782c2oemiJTw9RA61s10PwKW X9kWjPmULNVJQmdtLDzrB4Iu1SGq2pU1NTmxenT1bqJ/TSxhhrrtv+2Syx0CmmgkE9hFO+zD6J0XL nSjaRxd/CMXgF1MGAdXnmA==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qArMm-0000vj-Tp; Sun, 18 Jun 2023 08:18:49 -0400 In-Reply-To: (message from Konstantin Kharlamov on Sun, 18 Jun 2023 14:54:11 +0300) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:306978 Archived-At: > From: Konstantin Kharlamov > 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?