From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: Procedure for changing the FAQ Date: Wed, 23 Apr 2003 12:15:03 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <7680-Wed23Apr2003121503+0300-eliz@elta.co.il> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1051089540 1772 80.91.224.249 (23 Apr 2003 09:19:00 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 23 Apr 2003 09:19:00 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Apr 23 11:18:59 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 198GP5-0000SS-00 for ; Wed, 23 Apr 2003 11:18:59 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 198GUk-0000wO-00 for ; Wed, 23 Apr 2003 11:24:50 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 198GPB-0002Dc-04 for emacs-devel@quimby.gnus.org; Wed, 23 Apr 2003 05:19:05 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 198GOP-0000uq-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 05:18:17 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 198GOM-0000rR-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 05:18:15 -0400 Original-Received: from balder.inter.net.il ([192.114.186.15]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 198GOJ-0000iB-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 05:18:11 -0400 Original-Received: from zaretsky (cable-131-74.inter.net.il [213.8.131.74]) by balder.inter.net.il (Mirapoint Messaging Server MOS 3.2.2-GA) with ESMTP id CHF24536; Wed, 23 Apr 2003 12:18:08 +0300 (IDT) Original-To: emacs-devel@gnu.org X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: (message from Glenn Morris on Tue, 22 Apr 2003 16:45:07 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:13386 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:13386 > From: Glenn Morris > Date: Tue, 22 Apr 2003 16:45:07 +0100 > > Updating the FAQ is an etc/TODO item. Is there any kind of procedure > to be followed for this? Nothing special, the FAQ is just another part of the Emacs documentation. Treat it as you would anything else in the `man' subdirectory. > I assume one can just go ahead and update any old URLs, package > versions, etc. Yes, that's one thing that needs to be done occasionally. > But what about more drastic changes? For example, I think the "Emacs > Lisp Archive" is long dead, so I would propose to delete all > references to that and replace them with the "Emacs Lisp List" (and/or > the Wiki), which I think is the best current source for Emacs > packages. But others might not agree with me. If no one disagrees, please go ahead and do this. However, it might be a better idea to leave the reference to the archive and say that it was not updated in years. > What about adding new FAQs? Yes, please! > Does any kind of consensus have to be reached on what constitutes a > FAQ? Searching gnu.emacs.help and counting the number of times a question was asked will do, I guess. Asking here will also help, as several maintainers do read gnu.emacs.help and have some idea about what's asked frequently. > Similarly, should some kind of > discussion as to what is the best answer to any given FAQ take place? I think it's a good idea to run the answer by this list. > Basically, my question is: is it OK to make non-trivial changes to > the FAQ without discussion? It's okay to do that, yes. Personally, I don't recommend that, but I'm known to disagree on this with others, and I cannot call myself an active developer lately, so my opinions hardly matter too much. > Is man/faq.texi even the master copy of the FAQ or not? Yes. > It refers to emacs-faq@lerner.co.il as the FAQ maintainers. As the Copyright line shows, Reuven Lerner does not maintain the FAQ actively for a few years now; we do. You will see in "cvs annotate" that many non-trivial changes were done by us in the FAQ over the last years.