From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: tutorial or guidebook text for some complex topics Date: Mon, 23 Oct 2006 22:01:32 +0200 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1161633744 17209 80.91.229.2 (23 Oct 2006 20:02:24 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 23 Oct 2006 20:02:24 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 23 22:02:22 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Gc5zd-0008Sf-2n for ged-emacs-devel@m.gmane.org; Mon, 23 Oct 2006 22:01:53 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gc5zc-00042M-Pr for ged-emacs-devel@m.gmane.org; Mon, 23 Oct 2006 16:01:52 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gc5zO-00041U-Nf for emacs-devel@gnu.org; Mon, 23 Oct 2006 16:01:38 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gc5zN-000416-8M for emacs-devel@gnu.org; Mon, 23 Oct 2006 16:01:38 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gc5zN-000413-31 for emacs-devel@gnu.org; Mon, 23 Oct 2006 16:01:37 -0400 Original-Received: from [192.114.186.20] (helo=nitzan.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gc5zM-0005nT-Hu for emacs-devel@gnu.org; Mon, 23 Oct 2006 16:01:36 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-83-130-239-159.inter.net.il [83.130.239.159]) by nitzan.inter.net.il (MOS 3.7.3a-GA) with ESMTP id EZK88705 (AUTH halo1); Mon, 23 Oct 2006 22:01:31 +0200 (IST) Original-To: "Drew Adams" In-reply-to: X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:61062 Archived-At: > From: "Drew Adams" > Date: Mon, 23 Oct 2006 11:35:12 -0700 > > Suggestion for after the release - Suggestions for improving the docs don't need to be postponed until after the release, since docs changes can never screw the program. > What I would suggest is that the documentation be beefed up a little, to > help users understand these critters better. I'd like to suggest that these > topics be dealt with in a tutorial or user-guide manner, with examples to > help people learn what these critters can look like and how to use them. Adding tutorial is always a good idea, IMO, but the problem is that too few people ``in the know'' know how to write good tutorials and/or have enough time to do the job. Volunteers are welcome, as always.