From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yuan Fu 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 10:04:36 -0400 Message-ID: <32292E31-1603-4EF9-B772-EBD378C32F76@gmail.com> References: <875z8ortot.fsf@gkayaalp.com> <83lfhjkq0r.fsf@gnu.org> <8620B5CD-CA92-46BF-80A8-DBE7052F4CA6@gmail.com> Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32498"; mail-complaints-to="usenet@ciao.gmane.io" Cc: =?utf-8?Q?G=C3=B6ktu=C4=9F_Kayaalp?= , Eli Zaretskii , eduardo@mercovich.net, Stefan Kangas , emacs-devel To: Gregory Heytings Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Sep 11 16:06: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 1kGjgo-0008My-A7 for ged-emacs-devel@m.gmane-mx.org; Fri, 11 Sep 2020 16:06:10 +0200 Original-Received: from localhost ([::1]:40820 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kGjgn-0008PU-9b for ged-emacs-devel@m.gmane-mx.org; Fri, 11 Sep 2020 10:06:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43152) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kGjfR-0006yK-4R for emacs-devel@gnu.org; Fri, 11 Sep 2020 10:04:45 -0400 Original-Received: from mail-qk1-x732.google.com ([2607:f8b0:4864:20::732]:37086) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kGjfP-0008EH-2D; Fri, 11 Sep 2020 10:04:44 -0400 Original-Received: by mail-qk1-x732.google.com with SMTP id 16so9942653qkf.4; Fri, 11 Sep 2020 07:04:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=JcGfzRZSw9rG6AIwFYct6cz/OuVBn/PwgIn308Nwufw=; b=YNyYacow7Bq5RWaz/NyTjoeMCtQQuEPmevG7qWM3a+2TL4kLXfKN1sapLQR7CpgqCz jWSiLt/G/P4FMkeojWCm+IM4R2no9eJ4bUHgeROF5Fltu2MaJersIR7D/sDl6QRVXrSP nzp0e+Jee2ZsKw1NVXmeSzeJxbX6vHKvtExOj+hQC3t7ls/5B/vfgFfzjMXX7CCP/xMv Gw2/hboiMb9P+sQfP9klya4EKReUb529QSB1bUomvC40fDdmVNzU4Y7XcBNJhtfyaWgb 5r6B0n/9Q/52kdLLVtuexqOkImc5QjSnskPMULT8Em2+xXAj/3WhPv6pRe3M/XIdPdfH 67pA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=JcGfzRZSw9rG6AIwFYct6cz/OuVBn/PwgIn308Nwufw=; b=ER9e4i4ly0psmT1hs/s/CGvF7vNurHV45NaVD7IjqrfFFRTb9FVw5znU+LchRTyvWN njP+qKRWGdXRTKKWkLVI6E2QSP3YC3PkrMzQDQo7/AgzCz3av2QlMXwQrB5ZCjQo42LC D96LEPHVheOKogRO8Rm3kqh6nbgaMT2wsC2EJLbIuNkr5K40p6/7ayt0CxnEEtlj6E4R Vo6QUOUvwpsPAof16W81Z5vG6MGuS2V7cz08z5RxBsf9ihVXdgumsxuIiwgydJPDZB9f sAfBr4dAvVdtaHUPfMDgkBlGpSHPUo2SrnUDMGWKY1v5W2J8S3CxVDXOGoNbnycL3a6V xxBg== X-Gm-Message-State: AOAM532k8PALkeq3PcU4ZXxK/ygq96Qn7C1+MAi+TcLjw9cfJ0EjwRZx DfDV2FgpyK00na9SCTOlxHE= X-Google-Smtp-Source: ABdhPJzBo+aPTpqS0/ssCSgRmddC3TtdQDyldEXp9xfKCXAhJ6HllKksTaKOGKFLvgthQ8JLWDoBfQ== X-Received: by 2002:ae9:e8c5:: with SMTP id a188mr1660400qkg.204.1599833078493; Fri, 11 Sep 2020 07:04:38 -0700 (PDT) Original-Received: from ?IPv6:2601:98a:4200:9210:2079:6e36:6ee4:49e3? ([2601:98a:4200:9210:2079:6e36:6ee4:49e3]) by smtp.gmail.com with ESMTPSA id l11sm2332671qkk.35.2020.09.11.07.04.37 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 11 Sep 2020 07:04:37 -0700 (PDT) In-Reply-To: X-Mailer: Apple Mail (2.3608.120.23.2.1) Received-SPF: pass client-ip=2607:f8b0:4864:20::732; envelope-from=casouri@gmail.com; helo=mail-qk1-x732.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=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:255178 Archived-At: > On Sep 11, 2020, at 4:15 AM, Gregory Heytings wrote: >=20 >=20 >>=20 >>> I think there are a few configurations that a beginner would want to = change right after he starts Emacs, usually very basic settings. If you = think it=E2=80=99s a good idea, I can go to reddit and ask what people = missed when then started using Emacs for the first few minutes. >>>=20 >>> FWIW, here is a demo of the guide: https://youtu.be/0qMskTAR2aw >>>=20 >>> The demo inserts some configurations into ~/.emacs.d/init.el after = completion. >>=20 >> Such a beginners guide (wizard) is an excellent idea. And it is = great that you actually have code. Let's see what others think, but I = will optimistically add my comments below. >>=20 >=20 > It's great indeed, and not very far from what I had in mind. >=20 > In screen 1, it would be great (but I don't know if it is possible) to = allow the user to select a font (among a short set). >=20 > In screen 2, I would add evil-mode in the options. I would add the = "C-o =3D find-file" binding to "cua-mode". I don't think "s (super)" is = useful. And I would not write "We encourage you to learn the default = binding, because...", but "We encourage you to reconsider this choice = after some time, because...". >=20 > In screen 3, I would add hl-line, show-paren-mode, which-key, = column-number-mode, save-place-mode + desktop-save-mode (both with a = single choice). I would also add an option to have "(setq = uniquify-buffer-name-style 'forward) (setq uniquify-min-dir-content = 1024)". And an option to bind C-x C-b (and another shorter but less = useful binding, say C-b) to ibuffer. >=20 > I would move screen 4 after screen 2. >=20 > And I still think that a short "guided tour" would be useful at the = end: what/where is the minibuffer and what is its purpose, what does the = mode-line contain, how to find help (here I would list C-h m, C-h p, C-h = k / C-h w / C-h a, C-h l, C-h ?), =E2=80=A6 I agree, the current tutorial is a bit verbose (not that I didn=E2=80=99t = read it when I started using Emacs, but=E2=80=A6). A shorter tutorial = introducing the most important bindings and operations would be helpful = (I imagine). Yuan