all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Jeremy Bryant <jb@jeremybryant.net>
To: Eli Zaretskii <eliz@gnu.org>
Cc: Emanuel Berg <incal@dataswamp.org>, emacs-devel@gnu.org
Subject: Re: discoverability, better defaults and which-key in Emacs
Date: Sat, 03 Feb 2024 11:39:50 +0000	[thread overview]
Message-ID: <87mssh7owx.fsf@jeremybryant.net> (raw)
In-Reply-To: <86v877xqez.fsf@gnu.org>


Eli Zaretskii <eliz@gnu.org> writes:

>> From: Emanuel Berg <incal@dataswamp.org>
>> Date: Fri, 02 Feb 2024 08:00:22 +0100
>> 
>> Instead of Emacs finding out who is a new user or old, new and
>> old users alike should find what they look for in Emacs.
>> 
>> With configuration, maybe one can have a FAQ specifically for
>> that. If one has the 20 most common configuration use cases
>> listed with Elisp one-liners to do it, that would be a good
>> start. And beyond that, people already have experience anyway.
>
> This idea came up several times here, and was met with a general
> agreement, but no one stepped forward to work on those "most common
> configurations".  And it is not easy to do, since the configurations
> depend on the needs of the user (whether the user is a programmer and
> in what language(s), what other tasks and jobs does the user want to
> accomplish in Emacs -- email, todo items, etc.) and also some general
> user preferences (mouse vs keyboard etc.).
>
> Patches welcome, of course.

Would it be useful to have a few 'starter' commented init files /
configurations.
This would be a built-in version of personal init files, but very small,
and commented.

I can work on such minimal configurations, would you suggest a patch
somewhere specifically in the Emacs tree?  I can work on a patch.



>> Another case is finding code in core Emacs and in ELPA to do
>> stuff so one don't spend time writing Elisp for that oneself.
>> This is an area where I failed big time myself. Maybe today
>> googling can offer more as much more code is available online?
>
> The Emacs apropos commands, if used wisely, should help you.  You
> might find that some of our documentation needs to be enhanced to make
> discoverability easier, in which case please report the deficiencies,
> so we could make this better.
>
>> I for one would be very interested to know what of my Elisp
>> I can discard in favor of using stuff in core Emacs.
>> But I don't have a confident answer how to find out.
>
> Some Emacs commands I suggest for this are:
>
>   C-u M-x apropos
>   M-x apropos-documentation
>   C-h R elisp RET followed by 'i' (Info-index) and the subject

Would it make sense to have a specific small section in the Emacs manual
that
Then a link to that manual section could be provided early on
A sort of 'discoverability start point'?
I can work on a manual patch if you think this would be a good place for
it?



  parent reply	other threads:[~2024-02-03 11:39 UTC|newest]

Thread overview: 78+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-01-31 23:23 discoverability, better defaults and which-key in Emacs Jeremy Bryant
2024-02-01  2:45 ` Po Lu
2024-02-03 13:40   ` Philip Kaludercic
2024-02-04 22:03     ` Dmitry Gutov
2024-02-05  7:11       ` Philip Kaludercic
2024-02-05 15:38         ` Dmitry Gutov
2024-02-05 18:47           ` Philip Kaludercic
2024-02-05 19:17             ` Dmitry Gutov
2024-02-05 19:33               ` Justin Burkett
2024-02-05 23:05                 ` Dmitry Gutov
2024-02-06  2:49                   ` Justin Burkett
2024-02-06 23:12                     ` Dmitry Gutov
2024-02-07 12:35                       ` Eli Zaretskii
2024-02-07 18:31                         ` Dmitry Gutov
2024-02-07 19:13                           ` Eli Zaretskii
2024-02-07 19:51                             ` Dmitry Gutov
2024-02-08  1:46                           ` Visuwesh
2024-02-08  6:59                             ` Eli Zaretskii
2024-02-08 12:18                               ` Dmitry Gutov
2024-02-08 13:02                                 ` Eli Zaretskii
2024-02-08 13:36                                   ` Dmitry Gutov
2024-02-08 13:52                                     ` Eli Zaretskii
2024-02-08 14:43                                       ` Dmitry Gutov
2024-02-08 16:12                                         ` Dmitry Gutov
2024-02-11  2:17                                           ` Dmitry Gutov
2024-02-11  2:39                                             ` Po Lu
2024-02-11 12:30                                               ` Dmitry Gutov
2024-02-11  6:49                                             ` Eli Zaretskii
2024-02-11 12:26                                               ` Dmitry Gutov
2024-02-11 15:00                                                 ` Eli Zaretskii
2024-02-11 20:36                                                   ` Dmitry Gutov
2024-02-08 16:50                                         ` Eli Zaretskii
2024-02-08 13:41                                   ` Dmitry Gutov
2024-02-08 13:51                                   ` Rebinding Fn [Re: discoverability, better defaults and which-key in Emacs] Alan Mackenzie
2024-02-08 13:55                                     ` Eli Zaretskii
2024-02-08 14:04                                       ` Alan Mackenzie
2024-02-08 13:25                           ` discoverability, better defaults and which-key in Emacs Po Lu
2024-02-08 13:27                             ` Dmitry Gutov
2024-02-08 13:36                               ` Dmitry Gutov
2024-02-01  7:35 ` Eli Zaretskii
2024-02-01 21:16   ` Jeremy Bryant
2024-02-02  6:43     ` Eli Zaretskii
2024-02-02  7:00       ` Emanuel Berg
2024-02-02  7:43         ` Eli Zaretskii
2024-02-02 15:25           ` [External] : " Drew Adams
2024-02-02 15:53             ` Emanuel Berg
2024-02-02 16:04             ` Emanuel Berg
2024-02-03 11:46             ` Jeremy Bryant
2024-02-03 11:39           ` Jeremy Bryant [this message]
2024-02-03 12:12             ` Eli Zaretskii
2024-02-03 14:07               ` Jeremy Bryant
2024-02-03 15:15                 ` Eli Zaretskii
2024-02-04 22:18                   ` Jeremy Bryant
2024-02-05 12:41                     ` Eli Zaretskii
2024-02-03 11:30       ` Jeremy Bryant
2024-02-03 11:36       ` Moving which-key ELPA package into core - " Jeremy Bryant
2024-02-03 16:34         ` Stefan Monnier
2024-02-04 22:12           ` Jeremy Bryant
2024-02-04 23:06             ` Stefan Monnier
2024-02-01 21:17   ` orzodk
2024-02-01 22:24     ` Jeremy Bryant
2024-02-01 23:49       ` orzodk
2024-02-02  6:31     ` Eli Zaretskii
2024-02-02 16:00   ` Howard Melman
2024-02-02 19:24     ` Eli Zaretskii
2024-02-02 19:32       ` tomas
2024-02-02 20:16         ` Howard Melman
2024-02-03  7:25           ` Emanuel Berg
2024-02-03  8:49           ` Eli Zaretskii
2024-02-03 16:58             ` [External] : " Drew Adams
2024-02-04 22:25               ` Jeremy Bryant
2024-02-04 22:55                 ` Emanuel Berg
2024-02-05  3:40                   ` Emanuel Berg
2024-02-04 23:47                 ` Drew Adams
2024-02-05  1:46                   ` Emanuel Berg
2024-02-05  3:52               ` Divya Ranjan
2024-02-05 15:04                 ` Drew Adams
2024-02-04 18:34             ` Howard Melman

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

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87mssh7owx.fsf@jeremybryant.net \
    --to=jb@jeremybryant.net \
    --cc=eliz@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=incal@dataswamp.org \
    /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 external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.