From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Stefan Monnier" Newsgroups: gmane.emacs.devel Subject: Re: Procedure for changing the FAQ Date: Wed, 23 Apr 2003 09:11:10 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200304231311.h3NDBAs4012370@rum.cs.yale.edu> References: <7680-Wed23Apr2003121503+0300-eliz@elta.co.il> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1051103880 27516 80.91.224.249 (23 Apr 2003 13:18:00 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 23 Apr 2003 13:18:00 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Apr 23 15:17:58 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 198K8M-00079T-00 for ; Wed, 23 Apr 2003 15:17:58 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 198KE6-0003J9-00 for ; Wed, 23 Apr 2003 15:23:55 +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 198K5Y-0006YI-0C for emacs-devel@quimby.gnus.org; Wed, 23 Apr 2003 09:15:04 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 198K3g-0005CF-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 09:13:08 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 198K21-0004BA-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 09:11:25 -0400 Original-Received: from rum.cs.yale.edu ([128.36.229.169]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 198K1p-000458-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 09:11:13 -0400 Original-Received: from rum.cs.yale.edu (localhost [127.0.0.1]) by rum.cs.yale.edu (8.12.8/8.12.8) with ESMTP id h3NDBAx6012372 for ; Wed, 23 Apr 2003 09:11:10 -0400 Original-Received: (from monnier@localhost) by rum.cs.yale.edu (8.12.8/8.12.8/Submit) id h3NDBAs4012370; Wed, 23 Apr 2003 09:11:10 -0400 X-Mailer: exmh version 2.4 06/23/2000 with nmh-1.0.4 Original-To: emacs-devel@gnu.org 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:13393 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:13393 ...about the FAQ... I think the FAQ has generally not been maintained very well for the simple reason that such FAQs should be addressed by the manual rather than by a FAQ. Admittedly, the way it's presented is different, so there's some sense to having a FAQ additionally to the manual, but please think of it as another kind of index to the manual: most answers should @xref to the relevant part of the manual. If there's no such thing in the manual, then the manual needs to be updated. Of course the FAQ should probably not contain only @xref because people will find it obnoxious, so at least the core part of the answer should be present additionally to the @xref. That's my personal opinion anyway, I have no idea what others think about it. Stefan