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: Improving documentation of Org Mode integration into Emacs. Date: Mon, 10 Jan 2022 20:24:28 +0200 Message-ID: <83o84j8n4z.fsf@gnu.org> References: <87zgpgax7w.fsf@red-bean.com> <834k7n5zfu.fsf@gnu.org> <87fsq5tnni.fsf@red-bean.com> <87ee5mlvyc.fsf@red-bean.com> <83lezu9tv1.fsf@gnu.org> <87zgo4v8rb.fsf@red-bean.com> <87czl0j7vf.fsf@gmx.de> <87bl0kgdto.fsf@red-bean.com> <87zgo4hrjq.fsf@gmx.de> <87ilurftpw.fsf@red-bean.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3978"; mail-complaints-to="usenet@ciao.gmane.io" Cc: kyle@kyleam.com, michael.albinus@gmx.de, emacs-devel@gnu.org To: Karl Fogel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jan 10 19:33:13 2022 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 1n6zTk-0000qD-HA for ged-emacs-devel@m.gmane-mx.org; Mon, 10 Jan 2022 19:33:12 +0100 Original-Received: from localhost ([::1]:51872 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n6zTj-0002Rm-Kl for ged-emacs-devel@m.gmane-mx.org; Mon, 10 Jan 2022 13:33:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:58060) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6zLT-0008Rs-62 for emacs-devel@gnu.org; Mon, 10 Jan 2022 13:24:39 -0500 Original-Received: from [2001:470:142:3::e] (port=53344 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6zLS-00042x-9x; Mon, 10 Jan 2022 13:24:38 -0500 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=y90PZkx9i34nBrYRbz4cd/H2q4pEMGuUC6RJc/Ou0Vs=; b=nbqBiknwldqO jNM+h5AkpEi7pWWFrIC80ME68yboIAhpQHykmfTh+fIw1aUD9KvOXl0g/8ixh53pEJhBEyiD4ZKDh QIW76t6nUZpZxvugZ34mogPdIZX+0U1LcN2pEqwDWZMUQsQHgnsEaIvXLEl5OvF6xe0OzHoJQMMJ0 KD74YqNH1p3As1j0o6wYxUrichc4GHwH5gDIi+BAczx+mw3riHeTsQPk+hlbO0jxX3Nsus3zZPloW GBjWdtXUtOuX/XmBAptjThc55bUSNDbhRitIyXfeqmqjrVpamxMW1vYoFV+84Nleu/AlecINb6D9w FsgWbVhKMAti967OvGmxEw==; Original-Received: from [87.69.77.57] (port=2264 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 1n6zLS-0001Ls-9q; Mon, 10 Jan 2022 13:24:38 -0500 In-Reply-To: <87ilurftpw.fsf@red-bean.com> (message from Karl Fogel on Mon, 10 Jan 2022 10:20:27 -0600) 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" Xref: news.gmane.io gmane.emacs.devel:284546 Archived-At: > From: Karl Fogel > Date: Mon, 10 Jan 2022 10:20:27 -0600 > Cc: Kyle Meyer , emacs-devel@gnu.org > > >And the information about Tramp's bug tracker and backward > >compatibility (just pushed to the repo) makes it worthwile. > > Got it. So it sounds like the "Notes" field should give some > advice about checking the upstream sources and bug tracker first, > when trying to find out if a bug is already known/addressed. And > if you're happy to accept patches against the sources shipped in > Emacs, even when those sources are slightly out-of-date with > respect to what you have upstream, then "Notes" can say that too. IMO, that'd be in the "too much information" department. We don't need to say everything there, just enough for the people to know how to handle a bug report without wasting their time and ours.