From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Gregory Heytings via "Emacs development discussions." Newsgroups: gmane.emacs.devel Subject: Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have) Date: Fri, 11 Sep 2020 08:15:12 +0000 Message-ID: References: <875z8ortot.fsf@gkayaalp.com> <83lfhjkq0r.fsf@gnu.org> <8620B5CD-CA92-46BF-80A8-DBE7052F4CA6@gmail.com> Reply-To: Gregory Heytings Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="-212064758-835579115-1599809204=:28731" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31683"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Alpine 2.22 (NEB 394 2020-01-19) Cc: Stefan Kangas , Eli Zaretskii , =?UTF-8?Q?G=C3=B6ktu=C4=9F_Kayaalp?= , eduardo@mercovich.net, emacs-devel To: Yuan Fu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Sep 11 10:16:10 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 1kGeE5-00089Z-Qg for ged-emacs-devel@m.gmane-mx.org; Fri, 11 Sep 2020 10:16:09 +0200 Original-Received: from localhost ([::1]:59056 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kGeE4-0002rd-Te for ged-emacs-devel@m.gmane-mx.org; Fri, 11 Sep 2020 04:16:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57070) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kGeDV-0002Ls-N4 for emacs-devel@gnu.org; Fri, 11 Sep 2020 04:15:33 -0400 Original-Received: from mx.sdf.org ([205.166.94.24]:54582) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kGeDS-0007Ob-QH; Fri, 11 Sep 2020 04:15:33 -0400 Original-Received: from sdf.org (IDENT:ghe@faeroes.freeshell.org [205.166.94.9]) by mx.sdf.org (8.15.2/8.14.5) with ESMTPS id 08B8FFC3013353 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits) verified NO); Fri, 11 Sep 2020 08:15:15 GMT Original-Received: (from ghe@localhost) by sdf.org (8.15.2/8.12.8/Submit) id 08B8FPEO029221; Fri, 11 Sep 2020 08:15:25 GMT In-Reply-To: Content-ID: Received-SPF: pass client-ip=205.166.94.24; envelope-from=ghe@sdf.org; helo=mx.sdf.org X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/11 04:15:27 X-ACL-Warn: Detected OS = ??? X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:255110 Archived-At: This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---212064758-835579115-1599809204=:28731 Content-Type: text/plain; charset=ISO-8859-7; format=flowed Content-Transfer-Encoding: QUOTED-PRINTABLE Content-ID: > >> I think there are a few configurations that a beginner would want to=20 >> change right after he starts Emacs, usually very basic settings. If you= =20 >> think it=A2s a good idea, I can go to reddit and ask what people missed= =20 >> when then started using Emacs for the first few minutes. >> >> FWIW, here is a demo of the guide: https://youtu.be/0qMskTAR2aw >> >> The demo inserts some configurations into ~/.emacs.d/init.el after=20 >> completion. > > Such a beginners guide (wizard) is an excellent idea. And it is great=20 > that you actually have code. Let's see what others think, but I will=20 > optimistically add my comments below. > It's great indeed, and not very far from what I had in mind. In screen 1, it would be great (but I don't know if it is possible) to=20 allow the user to select a font (among a short set). In screen 2, I would add evil-mode in the options. I would add the "C-o = =3D=20 find-file" binding to "cua-mode". I don't think "s (super)" is useful.=20 And I would not write "We encourage you to learn the default binding,=20 because...", but "We encourage you to reconsider this choice after some=20 time, because...". In screen 3, I would add hl-line, show-paren-mode, which-key,=20 column-number-mode, save-place-mode + desktop-save-mode (both with a=20 single choice). I would also add an option to have "(setq=20 uniquify-buffer-name-style 'forward) (setq uniquify-min-dir-content=20 1024)". And an option to bind C-x C-b (and another shorter but less=20 useful binding, say C-b) to ibuffer. I would move screen 4 after screen 2. And I still think that a short "guided tour" would be useful at the end:=20 what/where is the minibuffer and what is its purpose, what does the=20 mode-line contain, how to find help (here I would list C-h m, C-h p, C-h k= =20 / C-h w / C-h a, C-h l, C-h ?), ... ---212064758-835579115-1599809204=:28731--