From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Info tutorial is out of date
Date: Tue, 18 Jul 2006 06:34:01 +0300
Message-ID: <u4pxfk2mu.fsf@gnu.org>
References: <EIENLHALHGIMHGDOLMIMGEMKCJAA.drew.adams@oracle.com>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: main.gmane.org
X-Trace: sea.gmane.org 1153193657 11643 80.91.229.2 (18 Jul 2006 03:34:17 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Tue, 18 Jul 2006 03:34:17 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jul 18 05:34:14 2006
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
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 1G2gLc-00028f-2e
	for ged-emacs-devel@m.gmane.org; Tue, 18 Jul 2006 05:34:12 +0200
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1G2gLb-00010O-JZ
	for ged-emacs-devel@m.gmane.org; Mon, 17 Jul 2006 23:34:11 -0400
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1G2gLQ-0000zp-B2
	for emacs-devel@gnu.org; Mon, 17 Jul 2006 23:34:00 -0400
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1G2gLP-0000zE-6J
	for emacs-devel@gnu.org; Mon, 17 Jul 2006 23:33:59 -0400
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1G2gLP-0000zB-3a
	for emacs-devel@gnu.org; Mon, 17 Jul 2006 23:33:59 -0400
Original-Received: from [192.114.186.66] (helo=romy.inter.net.il)
	by monty-python.gnu.org with esmtp (Exim 4.52) id 1G2gOC-00064a-QU
	for emacs-devel@gnu.org; Mon, 17 Jul 2006 23:36:53 -0400
Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-141-38.inter.net.il
	[80.230.141.38]) by romy.inter.net.il (MOS 3.7.3-GA)
	with ESMTP id FHG01567 (AUTH halo1);
	Tue, 18 Jul 2006 06:33:57 +0300 (IDT)
Original-To: "Drew Adams" <drew.adams@oracle.com>
In-reply-to: <EIENLHALHGIMHGDOLMIMGEMKCJAA.drew.adams@oracle.com>
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=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:57238
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/57238>

> From: "Drew Adams" <drew.adams@oracle.com>
> Date: Mon, 17 Jul 2006 16:01:16 -0700
> 
>     > I see no reason why we can't have two versions of the tutorial.
> 
>     One reason is that it's not easy to present the right one to the user
>     based on her reader.  Remember: learning Info is a bootstrap-kind of
>     problem--you learn to use a tool by using that same tool.  If we don't
>     make the beginning of the bootstrap 110% reliable (which includes
>     showing the right manual), the results will be catastrophic.
> 
> So, how do you deal with that problem currently, since there are apparently
> already two manuals?

By having the Info manual be the first item in the top-level menu.

> Your bootstrap doesn't need to teach anything about `n' and `p', does it?

I think it does, because users should know how to navigate the
structure of a manual.