Re: Proposal for an improved `help-for-help'

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Sun, 21 Feb 2021 17:27:51 -0600
> Cc: emacs-devel@gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > So it _is_ about the order.  But then I think we should discuss the
> > underlying principles, and then order the commands accordingly.
> >
> > The rationale for the order in the manual was to show the discovery
> > commands first, and the commands for focused help later.
> 
> To be honest, I didn't yet think very hard about this problem.  But
> sure, we can discuss it.  Any suggestions or ideas are welcome.
> 
> My preliminary thinking here is that we should probably start with
> something like `describe-mode' and perhaps `describe-bindings' -- things
> that are about the basic commands to find help about the task that the
> user is engaged in right now.  Maybe together with `describe-key', and
> `describe-command'.

Since there can be different use cases, and each one could favor a
different order, perhaps we should precede a short guide to the list?
Like

  If you look for some feature, try "discovery" group.
  If you look for documentation of a command or a variable or a mode,
  try ...

etc.