From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eduardo Mercovich Newsgroups: gmane.emacs.devel Subject: Re: Interactive guide for new users Date: Sat, 19 Sep 2020 14:53:41 -0300 Message-ID: <87a6xlac0q.fsf@mercovich.net> References: <875z8ortot.fsf@gkayaalp.com> <83lfhjkq0r.fsf@gnu.org> <8620B5CD-CA92-46BF-80A8-DBE7052F4CA6@gmail.com> <87d02haj4g.fsf@mercovich.net> <87ft7dn0um.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14749"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.3.3; emacs 27.1 Cc: =?utf-8?Q?G=C3=B6ktu=C4=9F_Kay?= =?utf-8?Q?aalp?= , Yuan Fu , Eli Zaretskii , Stefan Kangas , emacs-devel To: "Philip K." Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 19 20:43:45 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 1kJhpp-0003kT-Jx for ged-emacs-devel@m.gmane-mx.org; Sat, 19 Sep 2020 20:43:45 +0200 Original-Received: from localhost ([::1]:34356 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kJhpo-0005RI-Mm for ged-emacs-devel@m.gmane-mx.org; Sat, 19 Sep 2020 14:43:44 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47074) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kJhN3-0000ML-28 for emacs-devel@gnu.org; Sat, 19 Sep 2020 14:14:01 -0400 Original-Received: from paulo.mayfirst.org ([162.247.75.97]:53829) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kJhN1-0006NH-A1; Sat, 19 Sep 2020 14:14:00 -0400 Original-Received: from paulo.mayfirst.org (unknown [127.0.0.1]) by paulo.mayfirst.org (Postfix) with ESMTP id BEF8A3F27; Sat, 19 Sep 2020 14:13:57 -0400 (EDT) Original-Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: xxxxx) with ESMTPSA id 34FA53F21 In-reply-to: <87ft7dn0um.fsf@posteo.net> X-Virus-Scanned: ClamAV using ClamSMTP Received-SPF: none client-ip=162.247.75.97; envelope-from=eduardo@mercovich.net; helo=paulo.mayfirst.org X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/19 14:13:57 X-ACL-Warn: Detected OS = Linux 3.11 and newer 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_NONE=0.001, SPF_NONE=0.001, UNPARSEABLE_RELAY=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sat, 19 Sep 2020 14:40:08 -0400 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:256210 Archived-At: Hi Philip, thanks for your kind and fast feedback.=20 Sorry I replied to everyone in the thread, just wanted a slower jump into this pond. It looks like I'm now completely in the water. :D > An issue I can imagine is that a lot of the options that would be > displayed in a wizard like this wouldn't mean too much to newcomers. > [...]=20 That's why a sample step/screen is included. The options are (proposed to be) phrased in a way that could be understood without knowing emacs. I was actually doubting even to include in each a link to it's canonical URL (I assume that it would be the one already in the package manager). In the org-mode preferences "section" (let's call it that way because it may have many steps) for example, leading stars should be explained (of course, a screenshot would be the best): --8<---------------cut here---------------start------------->8--- Org-mode defines heading hierarchy with asteriscs (stars) as the 1st charac= ter and arrange the left-alignment according to the heading level: 1 close = to the left margin and other ones moving to the right. Some people prefer to have a simpler visual display and use only the alignment (and the font size and/or color) to show the heading hierarchy. Please select your option:=20 (1) Hide the leading stars (2) Leave visible the leading stars (9) I'd like to leave this step for now (you can always make it later). (0) I want to stop this wizard now. --8<---------------cut here---------------end--------------->8--- In this way, the User can always choose to stop, jump this option for now, or take one of them.=20 Also, there should be a way to go back (not included in this rough draft). > Without a way to test and find out what these options _mean_, > you would only be helping people that could already help themselves. Testing with users is one of my specialties, I would happily make a testing protocol before making the design, tests and development. In a way, it is like TDD, but with interaction design... --=20 eduardo mercovich Donde se cruzan tus talentos=20 con las necesidades del mundo,=20 ah=C3=AD est=C3=A1 tu vocaci=C3=B3n.=20 (An=C3=B3nimo)