From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: More metaproblem Date: Sat, 6 Dec 2014 08:44:08 -0800 (PST) Message-ID: References: <20141203142859.24393.98673@vcs.savannah.gnu.org> <20141203192721.GE12748@thyrsus.com> <547F6774.50700@cs.ucla.edu> <838uio5vjw.fsf@gnu.org> <20141203211447.GB15111@thyrsus.com> <871toge5zw.fsf@floss.red-bean.com> <83388v6hsq.fsf@gnu.org> <87egsftgd5.fsf@ktab.red-bean.com> <83egsf3yci.fsf@gnu.org> <87iohq6nvn.fsf@ktab.red-bean.com> <85bnnhkuep.fsf@stephe-leake.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1417884292 24486 80.91.229.3 (6 Dec 2014 16:44:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 16:44:52 +0000 (UTC) To: Stephen Leake , emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 17:44:43 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XxITK-0007o6-Kb for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 17:44:42 +0100 Original-Received: from localhost ([::1]:54882 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxITK-0007ey-8w for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 11:44:42 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43537) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxISy-0007dr-U4 for emacs-devel@gnu.org; Sat, 06 Dec 2014 11:44:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxISq-0004ik-78 for emacs-devel@gnu.org; Sat, 06 Dec 2014 11:44:20 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:23150) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxISq-0004ig-0E for emacs-devel@gnu.org; Sat, 06 Dec 2014 11:44:12 -0500 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sB6GiAo7011119 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 6 Dec 2014 16:44:11 GMT Original-Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sB6Gi9q6005482 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 6 Dec 2014 16:44:09 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sB6Gi9AM013865; Sat, 6 Dec 2014 16:44:09 GMT In-Reply-To: <85bnnhkuep.fsf@stephe-leake.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179188 Archived-At: > Whenever someone on this list says "please follow the standard", > they should _also_ mention ./CONTRIBUTORS, or one of the more > detailed files in admin/notes. That will get people used to > refering to those files, raise awareness of them, and encourage > people to keep them up to date. Yes. That's the same kind of thing we do for user questions about Emacs Lisp coding conventions etc.: (a) answer the question, but also (b) refer them to the relevant doc about it in the manuals. Would it hurt to put the information you refer to, which is aimed at Emacs contributors, into the Emacs manual, as a separate section? A priori, that makes sense to me, but then I don't see a logical separation between Emacs users and Emacs contributors anyway. IMO, it does not matter whether such info is detailed, boring, internal stuff. It would still be good to move it from other files to the official doc, and give it the proper love that such doc requires. I think that doing this might have these benefits: 1. Put more of an accent on it, for everyone. The content and form would need to be clear and complete, and kept up to date, but that should be the case anyway. 2. Let users know that they can contribute, and just what's involved (yes, in detail). 3. Encourage people to reference it, as they do now for questions about key-binding conventions etc. And I do mean "move", not copy. There should be a single place where such info resides and is kept up to date. My thought is that that place should be the Emacs manual. Just a thought. Disclaimer: I'm not familiar with the info I'm conjecturing about. It just sounds to me like this kind of info belongs in the manual, even if it is not considered useful to the average Emacs user. If you think that such info really does not belong in the Emacs manual, then perhaps a separate manual for it makes sense.