From: "Drew Adams" <drew.adams@oracle.com>
Subject: RE: Info tutorial is out of date
Date: Sun, 16 Jul 2006 10:33:41 -0700 [thread overview]
Message-ID: <EIENLHALHGIMHGDOLMIMIELFCJAA.drew.adams@oracle.com> (raw)
In-Reply-To: <E1G204L-00027h-DO@fencepost.gnu.org>
The first thing the tutorial should do is take a tour of
the menu-bar menu - that is, those menu items that are the most
important. This is also the opportunity to point out the key
bindings indicated in the menu. That is the
way to introduce the shortcuts `i', `s', and `l', for
instance - in passing.
The menu bar is no more convenient or clear than keys.
It's one less thing to teach, in order to get directly into the meat of what
we want to teach. The menu bar is *there*; it needs no explaining, no
practicing, no remembering.
The Info tutorial itself should be accessible (listed) in
the menu of the first node of the Info manual. Instead, it is only
mentioned in the text of that node, in terms of `h'.
I don't see the reason for this. Once a person is looking at the Info
manual, he doesn't need the tutorial any more. And he can still get to
it in the usual way.
But, then why do we introduce the tutorial in the first text of the Info
manual? We introduce it by mentioning `h'. I would instead put it in the
menu, pointing out that it is an optional node of the manual (and saying
clearly what it is).
And how else would someone get to the tutorial, except through the Info
manual?
Before entering the tutorial, we should tell
users how to exit it, to get back where they were.
I don't quite follow.
You enter with `h', and then what? Introduce `q' and `C-h i' to get back
where you were in the tutorial. And if the tutorial is not a node in the
Info manual, what happens when you reach the end of it? I'd rather see it as
an optional node within the Info manual.
BTW, `h' should not bring up the tutorial, it should display
a mini-version of what `C-h m' shows: a short list of the main
key bindings - about the same as what's in the
menu-bar menu, but with some explanation. There is no need
to have a key binding just to bring up the Info tutorial -
people won't be doing that 30 times a day.
I see your point, but at the same time, people using Info may not grasp
the idea of two-character commands.
What two-character command? Just `h' to show the major key bindings. Anyway,
they will need to grasp `C-h i' to get into Info and to get back into it. I
don't follow you here.
The node `Invisible text in Emacs Info' is incomprehensible to me
("invisible text is really a part of the text"!?). Yow! Why
are we telling users about killing and yanking Info text? (I guess
printing is OK.) Why is this near the beginning of the tutorial?
I really, really do not get this.
I agree -- why teach people about this in the tutorial?
Does anyone think this is desirable?
In general, instead of introducing so many key bindings
(e.g. `]'), the tutorial should spend the user's time taking
a tour of Info *functionality*. Touring the menu-bar menu is a
good way to explore the main functionalities: show what's there
and what it does. In addition to the features in the
menu-bar menu, teach SPC and DEL - that's about it.
Other commands such as ] are also functionality. They are a little
more advanced, as functionality goes, so perhaps they should come later.
Yes, and they are in the menu-bar. AFAIK, the only commands not in the
menu-bar are SPC and DEL.
By pointing out the existence of the menu-bar, and running users through
some of its items, users also learn the lesson that they can find Info
functionality there. Instead of remembering, six months later, the Info
lesson that ran through using `]', they can remember to check what's in the
menu-bar menu - there they'll be reminded that `]' is the binding, or
they'll learn about it for the first time.
prev parent reply other threads:[~2006-07-16 17:33 UTC|newest]
Thread overview: 114+ messages / expand[flat|nested] mbox.gz Atom feed top
2006-07-15 14:44 Info tutorial is out of date Drew Adams
2006-07-15 15:04 ` David Kastrup
2006-07-15 17:07 ` Drew Adams
2006-07-16 6:25 ` Richard Stallman
2006-07-16 17:33 ` Drew Adams
2006-07-16 18:02 ` Eli Zaretskii
2006-07-17 16:06 ` Richard Stallman
2006-07-20 19:03 ` Slawomir Nowaczyk
2006-07-20 23:10 ` Miles Bader
2006-07-21 1:11 ` Slawomir Nowaczyk
2006-07-15 17:46 ` Thien-Thi Nguyen
2006-07-15 23:41 ` Drew Adams
2006-07-16 8:29 ` Thien-Thi Nguyen
2006-07-16 17:33 ` Drew Adams
2006-07-16 17:52 ` Eli Zaretskii
2006-07-16 18:51 ` Thien-Thi Nguyen
2006-07-15 22:14 ` Alan Mackenzie
2006-07-15 22:56 ` martin rudalics
2006-07-15 23:41 ` Drew Adams
2006-07-15 23:41 ` Drew Adams
2006-07-16 0:26 ` Drew Adams
2006-07-16 6:23 ` David Kastrup
2006-07-16 17:33 ` Drew Adams
2006-07-16 17:49 ` David Kastrup
2006-07-20 19:03 ` Slawomir Nowaczyk
2006-07-16 18:42 ` Jay Belanger
2006-07-16 19:24 ` Lennart Borgman
2006-07-16 20:13 ` Jay Belanger
2006-07-16 20:28 ` Lennart Borgman
2006-07-20 19:03 ` Slawomir Nowaczyk
2006-07-20 19:35 ` Jay Belanger
2006-07-16 22:16 ` Mathias Dahl
2006-07-17 3:09 ` Stefan Monnier
2006-07-17 3:54 ` Luc Teirlinck
2006-07-17 5:07 ` Luc Teirlinck
2006-07-17 5:54 ` Eli Zaretskii
2006-07-17 16:54 ` Drew Adams
2006-07-17 19:06 ` Eli Zaretskii
2006-07-17 23:01 ` Drew Adams
2006-07-18 3:32 ` Eli Zaretskii
2006-07-18 4:37 ` Drew Adams
2006-07-18 19:42 ` Eli Zaretskii
2006-07-18 22:19 ` Drew Adams
2006-07-19 3:01 ` Eli Zaretskii
2006-07-17 16:37 ` Drew Adams
2006-07-17 19:01 ` Eli Zaretskii
2006-07-17 23:01 ` Drew Adams
2006-07-18 3:34 ` Eli Zaretskii
2006-07-18 4:37 ` Drew Adams
2006-07-18 19:43 ` Eli Zaretskii
2006-07-18 22:19 ` Drew Adams
2006-07-19 3:02 ` Eli Zaretskii
2006-07-18 13:37 ` Richard Stallman
2006-07-18 0:13 ` Richard Stallman
2006-07-18 4:40 ` Luc Teirlinck
2006-07-18 5:03 ` Drew Adams
2006-07-18 15:00 ` Richard Stallman
2006-07-17 4:20 ` Luc Teirlinck
2006-07-18 2:03 ` Miles Bader
2006-07-18 14:24 ` Stefan Monnier
2006-07-19 3:18 ` Miles Bader
2006-07-17 16:06 ` Richard Stallman
2006-07-17 16:37 ` Drew Adams
2006-07-17 17:03 ` Jay Belanger
2006-07-17 17:11 ` Drew Adams
2006-07-17 19:01 ` Jay Belanger
2006-07-17 23:01 ` Drew Adams
2006-07-17 13:21 ` Alan Mackenzie
2006-07-17 16:37 ` Drew Adams
2006-07-20 19:03 ` Slawomir Nowaczyk
2006-07-20 22:41 ` Richard Stallman
[not found] ` <87k66devap.fsf_-_@hans.local.net>
2006-07-16 20:28 ` Info tutorial is out of date; mouse usage David Kastrup
2006-07-16 21:13 ` Drew Adams
2006-07-16 9:08 ` Info tutorial is out of date Alan Mackenzie
2006-07-16 17:33 ` Drew Adams
2006-07-16 18:44 ` Thien-Thi Nguyen
2006-07-16 22:28 ` Mathias Dahl
2006-07-16 23:35 ` Alan Mackenzie
2006-07-16 22:57 ` Mathias Dahl
2006-07-17 1:07 ` Drew Adams
2006-07-17 9:33 ` Alan Mackenzie
2006-07-17 12:49 ` Robert J. Chassell
2006-07-17 8:19 ` Alan Mackenzie
2006-07-18 2:29 ` Miles Bader
2006-07-18 4:37 ` Drew Adams
2006-07-18 7:03 ` Thien-Thi Nguyen
2006-07-18 15:00 ` "shortcut" Richard Stallman
2006-07-19 3:35 ` Info tutorial is out of date Miles Bader
2006-07-17 1:40 ` Richard Stallman
2006-07-17 2:16 ` Jay Belanger
2006-07-17 9:44 ` Alan Mackenzie
2006-07-17 12:25 ` Sascha Wilde
2006-07-17 14:37 ` Mathias Dahl
2006-07-17 14:41 ` Lennart Borgman
2006-07-17 16:37 ` Drew Adams
2006-07-17 18:57 ` Eli Zaretskii
2006-07-17 23:01 ` Drew Adams
2006-07-18 9:38 ` Alan Mackenzie
2006-07-18 15:28 ` Drew Adams
2006-07-18 16:57 ` Thien-Thi Nguyen
2006-07-18 17:39 ` Drew Adams
2006-07-18 19:06 ` Thien-Thi Nguyen
2006-07-18 17:34 ` Thien-Thi Nguyen
2006-07-17 16:37 ` Drew Adams
2006-07-19 2:23 ` Brad Collins
2006-07-19 9:53 ` Alan Mackenzie
2006-07-19 14:38 ` Richard Stallman
2006-07-17 12:48 ` Robert J. Chassell
2006-07-18 0:12 ` Richard Stallman
2006-07-18 13:39 ` David Hansen
2006-07-16 2:16 ` Jorgen Schaefer
2006-07-16 17:30 ` Richard Stallman
2006-07-16 6:25 ` Richard Stallman
2006-07-16 17:33 ` Drew Adams [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=EIENLHALHGIMHGDOLMIMIELFCJAA.drew.adams@oracle.com \
--to=drew.adams@oracle.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).