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 23:02:23 +0300 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <9743-Wed23Apr2003230222+0300-eliz@elta.co.il> References: <7680-Wed23Apr2003121503+0300-eliz@elta.co.il> <200304231311.h3NDBAs4012370@rum.cs.yale.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1051129447 5817 80.91.224.249 (23 Apr 2003 20:24:07 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 23 Apr 2003 20:24:07 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Apr 23 22:24:00 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 198Qm5-0001RG-00 for ; Wed, 23 Apr 2003 22:23:25 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 198Qry-0007bZ-00 for ; Wed, 23 Apr 2003 22:29:31 +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 198Qlw-0006qQ-01 for emacs-devel@quimby.gnus.org; Wed, 23 Apr 2003 16:23:16 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 198QgZ-0004gF-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 16:17:43 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 198Qbt-0002mi-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 16:12:54 -0400 Original-Received: from thor.inter.net.il ([192.114.186.11]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 198QUE-0008HM-00 for emacs-devel@gnu.org; Wed, 23 Apr 2003 16:04:58 -0400 Original-Received: from zaretsky (tony08-235-245.inter.net.il [80.230.235.245] (may be forged)) by thor.inter.net.il (Mirapoint Messaging Server MOS 3.2.2-GA) with ESMTP id AXP70681; Wed, 23 Apr 2003 23:04:54 +0300 (IDT) Original-To: ich@Frank-Schmitt.net X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: (message from Frank Schmitt on Wed, 23 Apr 2003 16:08:25 +0200) 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:13404 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:13404 > From: Frank Schmitt > Date: Wed, 23 Apr 2003 16:08:25 +0200 > > I partly disagree, partly agree. First of all, the main documentation > is huge and the answers to the questions especially newbies have are > often in sections where they wouldn't expect them. That's what the indexing is for, and the `i' command inside Info. We should educate users to use that much more than they do, and we should strive to make our indexing even better. > Therefor a FAQ should explain all major concepts I disagree: I think explaining major concepts is something the FAQ should _not_ do; they are already explained in the manual. Yes, I know many computer users are used to look in the FAQ before they look in the manual, but I think we should convince Emacs users that's not the right way of looking something up in the docs.