From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: James Lu Newsgroups: gmane.emacs.devel Subject: Re: How to make Emacs popular again. Date: Sat, 26 Sep 2020 12:51:18 -0400 Message-ID: References: <20200926163008.GS1349@protected.rcdrun.com> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000029100e05b03a40ee" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15044"; mail-complaints-to="usenet@ciao.gmane.io" To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 26 18:52:55 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 1kMDRP-0003pg-1L for ged-emacs-devel@m.gmane-mx.org; Sat, 26 Sep 2020 18:52:55 +0200 Original-Received: from localhost ([::1]:58852 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kMDRN-0003qd-TO for ged-emacs-devel@m.gmane-mx.org; Sat, 26 Sep 2020 12:52:54 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51696) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMDQX-00035t-JB for emacs-devel@gnu.org; Sat, 26 Sep 2020 12:52:01 -0400 Original-Received: from mail-ot1-x332.google.com ([2607:f8b0:4864:20::332]:39003) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kMDQT-0002jX-2I for emacs-devel@gnu.org; Sat, 26 Sep 2020 12:52:00 -0400 Original-Received: by mail-ot1-x332.google.com with SMTP id u25so5393719otq.6 for ; Sat, 26 Sep 2020 09:51:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=Qpy+/GDrY2RsjX6cq4QP1/LGlWXzWGLEM1TvYmRGh9c=; b=OsXbuxbwVtp4z2vBERvqY94VE0S7glhoppIGgz/AUluH88AfLakds73e5PQhZxLEbs 1HJx66NeprL6JmHBhaqpi1xIv0z3Xq/0qv7Kka1aL1HuBhAtyA7oFDxDJimwNr+owNU4 2IZkPfbR6gPulmcmAPio38ObwmgCbc9WKU5JdkRIna7k87xoVue7o2hhM2Xgt9iJLce2 BJAzvtKNkKoseKiXTa06/CWOReUTHSqh5tpWtjvRDeT55KhXPREqe74lRsTcMjRkfHlb mxKK3NFVzAtNYIgIl1gelPIPOdYfkHCif/K74xWyoFN1+nwg/RkDmw+wESd41Cqxv21e aQfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=Qpy+/GDrY2RsjX6cq4QP1/LGlWXzWGLEM1TvYmRGh9c=; b=dMxfaPV3nzzEJUEr2puVjFL4xdNyb3pzl47HLOJmhVg33GNdwSMYO/E1hMn0qb4OY7 n1W+wohAtuxSKJ9IXGmtEWPeP3DKrKzJkdei7cSIG9lK/bH6ddgDoLrX6OpZZHGvzKPj sRMHU1l1HFAYDOWoyd12B5IsA2OljZk7UFV3VY/aKv9U3/CMPmW0XhpMjEG1s8UTejKQ Jb5tSSF1+UjeGie/S1HKk0ukkDT5cnsydRVJVq1/wc9BP8pQ1FhR/RFCMvksU6o1q7l6 0l6D4+8CnRuq8THPHaMTuFnRvPk4D+AcbWuK0okWx5v2VSGenAAyGIY1sYtluZ9oBiCw YtQw== X-Gm-Message-State: AOAM532T7KiADJZkLpddo7jTLN3MbJDWYdtdbyngUlDgTPCF1kWCqNCb rRoXxy8l8sa4KAvzR3h1Y1GuZqhwM8sCgADUnrgXQUWfqqBbsQ== X-Google-Smtp-Source: ABdhPJxu+UFtNUjpHJEeY7hSowlmvgubGslVIEsHdjuWEjaqExozPl/x3mKjq8GMlPMyvMc0j1vimrXFnPe8h0bVxEg= X-Received: by 2002:a05:6830:1e8a:: with SMTP id n10mr3986049otr.371.1601139114576; Sat, 26 Sep 2020 09:51:54 -0700 (PDT) In-Reply-To: <20200926163008.GS1349@protected.rcdrun.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::332; envelope-from=jamtlu@gmail.com; helo=mail-ot1-x332.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, HTML_MESSAGE=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:256482 Archived-At: --00000000000029100e05b03a40ee Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable > Emacs should have a built in support question system, so that every > user can straight send a support question, and which would be answered > by using referenced or hyperlinked easy English, and such question > would be then automatically placed on some website, or integrated > into Emacs, so next users could then inquire answers in easier and > easier manner. When you're paid to answer boring and repetitive questions, and you're expected to answer all of them, you have an economic incentive to create good documentation people want to read and is easy to find through. On Sat, Sep 26, 2020 at 12:30 PM Jean Louis wrote: > * James Lu [2020-09-26 16:40]: > > I am a new (2020 started) Emacs user. > > > > Sell customer support packages, so > > > 1) You can focus on gaining users giving more users computer user > > freedom and user empowerment. > > I understand what you mean. That is right and valid for any > software. And I am sure you mean it for interaction with the software. > > > 2) You can better understand the problems with Emacs' documentation > > and user interface > > Major problem there are abbreviations, words, terms, that are easily > misunderstood by users which may cause rejections. > > If I am faced with a Chinese menu and I do not speak Chinese, > obviously this will cause rejection and I will soonest possible stop > using such editor. For a Chinese person, that editor or piece of > software may become best thing they found and they may love it. > > By introducing a lot of Chinese-like terminology, let us call it > simply potential misunderstoods, users are rejecting whatever they > have in front of them. > > The remedy is already there, is it just not good enough. Good example > of remedy are tooltips. Example is what I have here on the mode line: > > -:**- > > So that is where the misunderstoods start, with -:**- so that looks > like Chinese to me, even though I know what it means as experienced > Emacs user. But from a view point of empowering a user, I have no clue > how is that empowering me. > > If I move the mouse point there to the first - I can see following > words inside of a tooltip: > > Buffer coding system (multi-byte): undecided-unix > Mouse-1: describe coding system > Mouse-3: set coding system > > So it is a tip, it should tell me some indications, but words are too > hard for new users, one could ask himself what really applies to that > definition of "buffer": > > * Overview of noun buffer > > The noun buffer has 7 senses (first 1 from tagged texts) > 1. (8) buffer -- ((chemistry) an ionic compound that resists changes in > its pH) > 2. buffer zone, buffer -- (a neutral zone between two rival powers that i= s > created in order to diminish the danger of conflict) > 3. fender, buffer, cowcatcher, pilot -- (an inclined metal frame at the > front of a locomotive to clear the track) > 4. buffer, buffer storage, buffer store -- ((computer science) a part of > RAM used for temporary storage of data that is waiting to be sent to a > device; used to compensate for differences in the rate of flow of data > between components of a computer system) > 5. buffer, polisher -- (a power tool used to buff surfaces) > 6. buffer, fender -- (a cushion-like device that reduces shock due to an > impact) > 7. buff, buffer -- (an implement consisting of soft material mounted on a > block; used for polishing (as in manicuring)) > > So there are plenty of ways how new user can get misunderstoods. Do > not assume that such has a ready Wordnet dictionary to do > {M-x wordnut-search} like I do. They most probably don't have it. > > A tooltip in Emacs user interface should have the option to be > "caught" or examined, that it does not disappear, so that now user can > click on words such as "buffer" and find out the definition of it, > that user can understand what means "coding" in the context of buffer > coding system, that user can understand what means "multi-byte", and > what does it mean UNIX and what does it mean "undecided-unix", as if > user does not know that, there is no reason or point to use the > Mouse-1 to describe the coding system, as it really does not describe > nothing to the user: > > > - -- undecided-unix (alias: unix) > > Why is it undecided?! It is unclear. Why is alias "unix"?! It is > unclear, why not call it unix?! Why is it alias? What is alias? > Consider my questions with !? hypothetical questions that user could > be asking. > > > No conversion on encoding, automatic conversion on decoding. > > This sentence says nothing. It is clear to developer what it means, > but is unclear to average user. > > Conversion of what?! It is not specified. > > Encoding of what?! It is no specified. > > What would mean "automatic conversion"?! > > Decoding of what?! > > > Type: undecided (do automatic conversion) > > Who is undecided?! User or computer? If it is undecided why is it > automatic?! > > > EOL type: LF > > No definition for this if I do: "!define EOL" inside of > duckduckgo.com, I get this: https://www.thefreedictionary.com/EOL > > For LF I am asking myself, is it left field or low frequency: > https://www.thefreedictionary.com/LF > > Of course I do know what Line Feed means, but average beginner will > not know it. > > And there is no recourse within Emacs to find out about it. > > Thus to conclude my example here: > > - Making Emacs friendlier will be easier with a built-in dictionary > that will describe any terminology in easy English > > - all tooltips, all words, should be describable and definable by > clicking the mouse or choosing {M-x define-word} or similar > function. Just all. I am talking about easy English description of > Menus, it is analogous to {C-h k} to describe the menu, but in easy > way, without confusing the user more and more. > > Another practical example of nonsense within Emacs, but don't take me > for a negative critic, I like Emacs now so much more because of > nonsense descriptions, but look at this: > > - I press {C-h k} and then choose Tools -> Search Files (Grep)... > > Side comment: if it runs "grep" command, I don't know why it is > capitalized, but alright. > > I wanted to find out about "Search Files..." so the menu option is > pretty clear, it helps me search files, but then description about > "Search files" does not even mention the word "search". > > It mentions other things, like I would not know why is it > so written, tools, grep, it does not help me understand what "grep" > means, I cannot find it in my Wordnet dictionary as definition, and > the the Duck is redirecting "!define grep" to Unix word, so I have no > option to understand what "grep" would mean, it is confusing me and I > am prone to reject it. > > Look what I read as description of a "Search Files (Grep...)" option > menu: > > > > runs the command grep (found in global-map), > > which is an autoloaded interactive compiled Lisp function in > > =E2=80=98grep.el=E2=80=99. > > > It is bound to . > > > (grep COMMAND-ARGS) > > > Probably introduced at or before Emacs version 1.4. > > > Run Grep with user-specified COMMAND-ARGS. > > The output from the command goes to the "*grep*" buffer. > > > While Grep runs asynchronously, you can use C-x ` (M-x next-error), > > or RET in the *grep* buffer, to go to the lines where Grep found > > matches. To kill the Grep job before it finishes, type C-c C-k. > > > Noninteractively, COMMAND-ARGS should specify the Grep command-line > > arguments. > > > For doing a recursive =E2=80=98grep=E2=80=99, see the =E2=80=98rgrep=E2= =80=99 command. For running > > Grep in a specific directory, see =E2=80=98lgrep=E2=80=99. > > > This command uses a special history list for its COMMAND-ARGS, so you > > can easily repeat a grep command. > > > A prefix argument says to default the COMMAND-ARGS based on the current > > tag the cursor is over, substituting it into the last Grep command > > in the Grep command history (or into =E2=80=98grep-command=E2=80=99 if = that history > > list is empty). > > > [back] > > For a new user, only two things make sense there: > > - The term "Search files", that is what makes sense > > - within the description of menu option "Search files" the only thing > that makes sense is [back] link > > > because people will email you support questions on them, > > Emacs should have a built in support question system, so that every > user can straight send a support question, and which would be answered > by using referenced or hyperlinked easy English, and such question > would be then automatically placed on some website, or integrated > into Emacs, so next users could then inquire answers in easier and > easier manner. > > Jean > --00000000000029100e05b03a40ee Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
>=C2= =A0Emacs should have a built in support question system, so that every
> user can straight = send a support question, and which would be answered
> by using referenced or hyperlinked easy Engli= sh, and such question
> w= ould be then automatically placed on some website, or integrated
> into Emacs, so next users could t= hen inquire answers in easier and
&= gt; easier manner.

When you're paid to answer boring and repetitive=C2=A0questio= ns, and
you're expected to answer= all of them, you have an economic
i= ncentive to create good documentation people want to read
and is easy to=C2=A0find through.

On Sat, Sep 2= 6, 2020 at 12:30 PM Jean Louis <bugs@= rcdrun.com> wrote:
* James Lu <jamtlu@gmail.com> [2020-09-26 16:40]:
> I am a new (2020 started) Emacs user.
>
> Sell customer support packages, so

> 1) You can focus on gaining users giving more users computer user
> freedom and user empowerment.

I understand what you mean. That is right and valid for any
software. And I am sure you mean it for interaction with the software.

> 2) You can better understand the problems with Emacs' documentatio= n
> and user interface

Major problem there are abbreviations, words, terms, that are easily
misunderstood by users which may cause rejections.

If I am faced with a Chinese menu and I do not speak Chinese,
obviously this will cause rejection and I will soonest possible stop
using such editor. For a Chinese person, that editor or piece of
software may become best thing they found and they may love it.

By introducing a lot of Chinese-like terminology, let us call it
simply potential misunderstoods, users are rejecting whatever they
have in front of them.

The remedy is already there, is it just not good enough. Good example
of remedy are tooltips. Example is what I have here on the mode line:

=C2=A0-:**-

So that is where the misunderstoods start, with -:**- so that looks
like Chinese to me, even though I know what it means as experienced
Emacs user. But from a view point of empowering a user, I have no clue
how is that empowering me.

If I move the mouse point there to the first - I can see following
words inside of a tooltip:

Buffer coding system (multi-byte): undecided-unix
Mouse-1: describe coding system
Mouse-3: set coding system

So it is a tip, it should tell me some indications, but words are too
hard for new users, one could ask himself what really applies to that
definition of "buffer":

* Overview of noun buffer

The noun buffer has 7 senses (first 1 from tagged texts)
1. (8) buffer -- ((chemistry) an ionic compound that resists changes in its= pH)
2. buffer zone, buffer -- (a neutral zone between two rival powers that is = created in order to diminish the danger of conflict)
3. fender, buffer, cowcatcher, pilot -- (an inclined metal frame at the fro= nt of a locomotive to clear the track)
4. buffer, buffer storage, buffer store -- ((computer science) a part of RA= M used for temporary storage of data that is waiting to be sent to a device= ; used to compensate for differences in the rate of flow of data between co= mponents of a computer system)
5. buffer, polisher -- (a power tool used to buff surfaces)
6. buffer, fender -- (a cushion-like device that reduces shock due to an im= pact)
7. buff, buffer -- (an implement consisting of soft material mounted on a b= lock; used for polishing (as in manicuring))

So there are plenty of ways how new user can get misunderstoods. Do
not assume that such has a ready Wordnet dictionary to do
{M-x wordnut-search} like I do. They most probably don't have it.

A tooltip in Emacs user interface should have the option to be
"caught" or examined, that it does not disappear, so that now use= r can
click on words such as "buffer" and find out the definition of it= ,
that user can understand what means "coding" in the context of bu= ffer
coding system, that user can understand what means "multi-byte", = and
what does it mean UNIX and what does it mean "undecided-unix", as= if
user does not know that, there is no reason or point to use the
Mouse-1 to describe the coding system, as it really does not describe
nothing to the user:

> - -- undecided-unix (alias: unix)

Why is it undecided?! It is unclear. Why is alias "unix"?! It is<= br> unclear, why not call it unix?! Why is it alias? What is alias?
Consider my questions with !?=C2=A0 hypothetical questions that user could<= br> be asking.

> No conversion on encoding, automatic conversion on decoding.

This sentence says nothing. It is clear to developer what it means,
but is unclear to average user.

Conversion of what?! It is not specified.

Encoding of what?! It is no specified.

What would mean "automatic conversion"?!

Decoding of what?!

> Type: undecided (do automatic conversion)

Who is undecided?! User or computer? If it is undecided why is it
automatic?!

> EOL type: LF

No definition for this if I do: "!define EOL" inside of
duck= duckgo.com, I get this: https://www.thefreedictionary.com/E= OL

For LF I am asking myself, is it left field or low frequency:
https://www.thefreedictionary.com/LF

Of course I do know what Line Feed means, but average beginner will
not know it.

And there is no recourse within Emacs to find out about it.

Thus to conclude my example here:

- Making Emacs friendlier will be easier with a built-in dictionary
=C2=A0 that will describe any terminology in easy English

- all tooltips, all words, should be describable and definable by
=C2=A0 clicking the mouse or choosing {M-x define-word} or similar
=C2=A0 function. Just all. I am talking about easy English description of =C2=A0 Menus, it is analogous to {C-h k} to describe the menu, but in easy<= br> =C2=A0 way, without confusing the user more and more.

Another practical example of nonsense within Emacs, but don't take me for a negative critic, I like Emacs now so much more because of
nonsense descriptions, but look at this:

- I press {C-h k} and then choose Tools -> Search Files (Grep)...

Side comment: if it runs "grep" command, I don't know why it = is
capitalized, but alright.

I wanted to find out about "Search Files..." so the menu option i= s
pretty clear, it helps me search files, but then description about
"Search files" does not even mention the word "search".=

It mentions other things, like <menu-bar> I would not know why is it<= br> so written, tools, grep, it does not help me understand what "grep&quo= t;
means, I cannot find it in my Wordnet dictionary as definition, and
the the Duck is redirecting "!define grep" to Unix word, so I hav= e no
option to understand what "grep" would mean, it is confusing me a= nd I
am prone to reject it.

Look what I read as description of a "Search Files (Grep...)" opt= ion
menu:


> <menu-bar> <tools> <grep> runs the command grep (fou= nd in global-map),
> which is an autoloaded interactive compiled Lisp function in
> =E2=80=98grep.el=E2=80=99.

> It is bound to <menu-bar> <tools> <grep>.

> (grep COMMAND-ARGS)

>=C2=A0 =C2=A0Probably introduced at or before Emacs version 1.4.

> Run Grep with user-specified COMMAND-ARGS.
> The output from the command goes to the "*grep*" buffer.

> While Grep runs asynchronously, you can use C-x ` (M-x next-error), > or RET in the *grep* buffer, to go to the lines where Grep found
> matches.=C2=A0 To kill the Grep job before it finishes, type C-c C-k.<= br>
> Noninteractively, COMMAND-ARGS should specify the Grep command-line > arguments.

> For doing a recursive =E2=80=98grep=E2=80=99, see the =E2=80=98rgrep= =E2=80=99 command.=C2=A0 For running
> Grep in a specific directory, see =E2=80=98lgrep=E2=80=99.

> This command uses a special history list for its COMMAND-ARGS, so you<= br> > can easily repeat a grep command.

> A prefix argument says to default the COMMAND-ARGS based on the curren= t
> tag the cursor is over, substituting it into the last Grep command
> in the Grep command history (or into =E2=80=98grep-command=E2=80=99 if= that history
> list is empty).

> [back]

For a new user, only two things make sense there:

- The term "Search files", that is what makes sense

- within the description of menu option "Search files" the only t= hing
=C2=A0 that makes sense is [back] link

> because people will email you support questions on them,

Emacs should have a built in support question system, so that every
user can straight send a support question, and which would be answered
by using referenced or hyperlinked easy English, and such question
would be then automatically placed on some website, or integrated
into Emacs, so next users could then inquire answers in easier and
easier manner.

Jean
--00000000000029100e05b03a40ee--