From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Interactive guide for new users Date: Sat, 12 Sep 2020 12:55:31 +0300 Message-ID: <83d02re2uk.fsf@gnu.org> References: <875z8ortot.fsf@gkayaalp.com> <83lfhjkq0r.fsf@gnu.org> <8620B5CD-CA92-46BF-80A8-DBE7052F4CA6@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31314"; mail-complaints-to="usenet@ciao.gmane.io" Cc: casouri@gmail.com, emacs-devel@gnu.org To: Gregory Heytings Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 12 11:56:25 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kH2Gf-000830-6t for ged-emacs-devel@m.gmane-mx.org; Sat, 12 Sep 2020 11:56:25 +0200 Original-Received: from localhost ([::1]:37214 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kH2Ge-0004KT-Ar for ged-emacs-devel@m.gmane-mx.org; Sat, 12 Sep 2020 05:56:24 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58526) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kH2G6-0003to-1H for emacs-devel@gnu.org; Sat, 12 Sep 2020 05:55:50 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:60646) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kH2G5-0003eN-26; Sat, 12 Sep 2020 05:55:49 -0400 Original-Received: from [176.228.60.248] (port=1509 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kH2Fp-0004OT-0A; Sat, 12 Sep 2020 05:55:36 -0400 In-Reply-To: (emacs-devel@gnu.org) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:255287 Archived-At: > Date: Sat, 12 Sep 2020 09:31:06 +0000 > From: Gregory Heytings via "Emacs development discussions." > > > Based on the feedback received so far, I reworked the proposal a bit. Thanks for thinking about this. I have a few minor comments. > The idea is to create an "initial greeting" that would be bundled with > Emacs, and would be executed the first time the first time Emacs is > launched (instead of the initial splash screen). What is the definition of "the first time"? where will we keep the indication that this is/isn't "the first time"? Also, will this affect "emacs -Q" or "emacs -q"? > SCREEN 1: Welcome! It seems that this is the first time you run Emacs, > would you like to customize its interface and have a short introduction? > This will not take you more than three minutes. I presume this will have a button "Not now" and "Don't show this again" or somesuch? > SCREEN 2: "Set the color theme", with a clickable list containing the > (currently) 16 built-in themes. A short code snippet above that list > illustrates how code is displayed with each of these themes. The snippet will only be able to show the buffer text appearance. For other UI elements you will need an image. Would using an image be better here? > [It would be nice to have a way to select a default font here, but I > don't know if that feasible.] I don't think I understand what you mean by that. Selection of the default font _is_ possible, we have in the Options menu. > SCREEN 4: Choose whether to set some common options that new users might > want (because they are common in other text editors). These are (the > order could be improved, and items could be added or removed): We should carefully construct the list of the options, they shouldn't just be someone's personal preferences. > 2. disable tool-bar-mode > 3. disable scroll-bar-mode I'd object to these two. We have just established that the former is important for newbies. Scroll bars are presented by many applications, so why is it important to offer to turn them off here? let the users decide about these two. > 6. hl-line-mode Why is this important? do other IDEs have it by default? > 8. which-key-mode I disagree with this one, certainly in its current form. > 10. save-place-mode and desktop-save-mode desktop-save-mode slows down startup, so it might not be suitable for users who start Emacs many times a day. > 11. (setq uniquify-buffer-name-style 'forward uniquify-min-dir-content 1024) Why? what's wrong with the defaults here? > 14. icomplete-mode (or fido-mode?) Not sure this is a good idea, these modes present complex and potentially confusing UI. > 16. display-time-mode Why? Any modern desktop has the time displayed somewhere, so this just occupies space on the mode line. > SCREEN 6: How to find help. Short explanation about C-h C-h, C-h m, C-h > p, C-h k / C-h w / C-h a, C-h l. This misses important help commands, we should consider the list carefully with newbies in mind. IMO, the various apropos commands are much more important for them than other help commands. > SCREEN 8: Thank you. Your choices have been saved in Emacs' configuration > file ~/.emacs.d/init.el (or ~/.emacs ?). What do we do here wrt XDG preferences? > You can use M-x initial-greeting at any time to go through this > configuration again. That command should be on the Help menu. And I think the name should be 'introduction-to-emacs' or somesuch.