From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: [External] : Re: [PATCH] Package Installation in Tutorial Date: Fri, 3 Dec 2021 18:53:41 +0000 Message-ID: References: <864k7ro07p.fsf@mail.linkov.net> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23063"; mail-complaints-to="usenet@ciao.gmane.io" To: Daniel Fleischer , "emacs-devel@gnu.org" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Dec 03 19:56:29 2021 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 1mtDjQ-0005rC-6r for ged-emacs-devel@m.gmane-mx.org; Fri, 03 Dec 2021 19:56:28 +0100 Original-Received: from localhost ([::1]:55938 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtDjP-0001SU-1Z for ged-emacs-devel@m.gmane-mx.org; Fri, 03 Dec 2021 13:56:27 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:34816) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtDgv-0006As-DZ for emacs-devel@gnu.org; Fri, 03 Dec 2021 13:53:53 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:33276) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtDgs-00057m-HH for emacs-devel@gnu.org; Fri, 03 Dec 2021 13:53:53 -0500 Original-Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1B3HcoxY019859; Fri, 3 Dec 2021 18:53:46 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=O4NECXgc5qH23B9AsBk53HRZBgAOE/1oUS2Glx7dexo=; b=qQKdlA3w0LEDN3NaTpKye8r4gU5xsl2jc5W58IUameQ9/RwBIEwc7aWRXDea/BAbhGr3 FhzvmjqvLhDWFZSluWNAgmUD20QI0pMY7LMdU+gacsCPU53vBy0ftzlSI4UPsRcsEibi kEGALO+54hTpJzGBWaSIXvwTyWRWpd6b0UTaJCZV7POBhxYYIhIzI3ji2f19u1wmoZXm Mi3kHXO01FfyCp99tiW9YNZEkZQNDMiIO6tIHTNJDBrzAElNn3aU0cB9ATZ05n/rda9Z Ugc4Q1vnCrtK4NwmyNtvVSxLh5f6ETl0yTTNkbHG8ly3H86mAhuvLwyLq2ZwUxYSOHcZ Rw== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by mx0b-00069f02.pphosted.com with ESMTP id 3cqn99hd49-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 03 Dec 2021 18:53:45 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1B3IjwgS065939; Fri, 3 Dec 2021 18:53:44 GMT Original-Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2169.outbound.protection.outlook.com [104.47.59.169]) by aserp3020.oracle.com with ESMTP id 3cnhvjvj7q-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 03 Dec 2021 18:53:43 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Ob5oQ7vHnitonUww1v2xWOzapuyBW+RVqvUxMU8EGYVUIpqd0Xj7pnC0EEvYgtPDfnZXdUXq+vxm+j8HKttoxB/35NanmS1UzB9Rvj3xtOJH8wE5S+YB9Cpkq/JVmyHyXWdx4oL0Iu+XGPkxJoeCoIpvrk8/bvuzV1UqJvhgvwml2StCbQ7AW9ztFkv25Zz4rg+h5i9yCaOs1mVlgFxmSkSnokapVSz1hp+MCJloAuIJ0lBo0vgPz/EKm/2T2tm9GqSJRzzZ+rksVIuaTmqj2tdoxycA285/68uI7JYgshdjmhlGPulgGE/g01EF7sREwHSSdLO8dwzNBR7hRAd2/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=O4NECXgc5qH23B9AsBk53HRZBgAOE/1oUS2Glx7dexo=; b=lcXPtMzsfaNG8Xvyq9x0RuYOV13xeP3AwCLo9WIcY59YPNoIYaFIPYo5GZtGMR2LuKRTfmax4FRCOs19dn3yH2R73sdEyX1/W4YF+TlY1WqvAGe7vhhVm0YPZA7MWxE066gt6ul+w6iciyC04Q5p4Mq1anSLI2W7t/uicjvggicmv7pihoIiAO3QosSRJnNRBeGVc8bpIjvX23vG3d867JcNjRaGgzY3xEcN/TxkWP2ZRODj9dmW23i2p0m0FFLtJhidu6AYby2IKrELzvG7vcshgxUrYbVh9PSvbDtUR9GxPz7HVq97lrtc5zLQ6Xr2fNU69ldsAUu9V67Y4rTMoQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=O4NECXgc5qH23B9AsBk53HRZBgAOE/1oUS2Glx7dexo=; b=lTXFeNl0/r1u7k40ODTA1FbVr7+wTce+bdzIzFVOzROEkaxPcQrvN6knn0DVUAVTIH/A9rgYAB1uMbll9uXS/YP6x+j7yHyYmYLPRclue8oRScjRk6g+LQS+103SptuybXmrIEGsmxIu1AKUGdrzSm0IoujyMgnbmdqCXwSlyvU= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BYAPR10MB2759.namprd10.prod.outlook.com (2603:10b6:a02:b5::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4755.16; Fri, 3 Dec 2021 18:53:41 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0%9]) with mapi id 15.20.4734.024; Fri, 3 Dec 2021 18:53:41 +0000 Thread-Topic: [External] : Re: [PATCH] Package Installation in Tutorial Thread-Index: AQHX6G4ehZ+LJO8nC0eG9gHsC/sJwKwhEciQ In-Reply-To: Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 6a5cf161-accc-4dd7-4055-08d9b68e39a8 x-ms-traffictypediagnostic: BYAPR10MB2759: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Am4XzrEOe+dLihihP1xRpnmKbOAc+JJcjilGpK6SsKB2iR+meV55muA87F/VWYTy9q7A2JuuvNO7AjpiH6PfWmG9Cg3xUD86mwRlVJwLcqYF02v+0GJLlYNLt/EEP9+RiVlnSMDV/fGyu2PnEj3rN5yX1DHH5vjLlOzk5yYJbCttj/7HXMA/0b/uEcNvF6DE5nUwnKPD+sPCJgOFCQFFPYLk6snAGcK3w1p5loApRfyyws7OQlve6a2MjX1r+UjzuHnOM/vFWRSJP06+GeusDPuUvMolgjGRCDLFbjKIbHHnGWSk8ajgzWvDUnrFPjK6PmKUjcaIu1n5mSJ7KSHpmO9FL4QYBiaH8DBRPcFKWPTqkgzlTLpz3hGqTVLOCTi6EYroyKxMLqhLqBVuSc4YJ+Zcwo0X3TthB0LOcijNGTjEPdv8S3MSUM/tMaV7YLRJ8zFiSQzOE80WVKnBquwVTpNXySJEGrc3QIVgevnRebBmm+hd/Y+lmH7IoT5wsMI1nrR57t7WB2EuiGK75ZUZtDJT1r5kxjHaboBNCeUJ7eXgJJZiLwABcPdJSjMEa+4cXjbdWtdNF8ySyh8wq+JrZ59S20SUEeaWTO4E9EL+v2944pB565xT4B7sC0Q+1M0QGvdeRHdpxYkmM+8LWaJnKKtlEl3hnWruD0A+/x7Wnf1BeLA3Moym58yy5I5m4ITYVU3wJTAVtE2bGFGMxcqfrw== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(7696005)(8936002)(71200400001)(122000001)(44832011)(86362001)(6506007)(508600001)(52536014)(38100700002)(9686003)(5660300002)(26005)(8676002)(38070700005)(186003)(33656002)(2906002)(55016003)(76116006)(66556008)(64756008)(83380400001)(66946007)(66476007)(316002)(110136005)(66446008); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?MqiDN7c1sAT5ocy1XoWeX5pnwr9TqE1syf0C0nWMI1JWLr8VSqhzaWu1jJPd?= =?us-ascii?Q?+/KwKq6xyNWNOL+NqTN9QSLacvZYbUjNYsi5DUEyj+IHHH6E859/HBG3ZHGP?= =?us-ascii?Q?kAg8VvtOIi/UnDBfJe5takRThd/MYJQfZDHKQQ/k0taFNUenzfcdzsD7uzOX?= =?us-ascii?Q?6pK+mgLkdcYoeOx4UHLGxwXvOJz66oDEVcX2DwiSg0Ft1YaUZJiGxNSBW1xv?= =?us-ascii?Q?U3pa/wuWNPrAVcy2VTrQHN8ox8ZE34thscO+J23bjlFWcHi6UQRD41adimf0?= =?us-ascii?Q?IeMcRmNu0cdb4AC5NbRST/nzUjBuaG/Wd+U6TPCfbcM+hWHDwV5zNQ/pId7G?= =?us-ascii?Q?M+vVfkLIoAeJxp5/DwSIK7mu0+yOzvbfpHzTPZHBXxP0EeFIYhNm56Fz707O?= =?us-ascii?Q?dE6VaeIguX7LGdYmkjWeXjQv2bV3t8eN7Z4ExtUdpkei43tdgfTSNEwhhxop?= =?us-ascii?Q?FpJU26nle6BmBMyGWJ8Xd+cn/sxCoWYFPq/zsZwyxLiGmj32nM3VYgMm8eFc?= =?us-ascii?Q?RWmYtcm70dn8CAUvfPd0r4z9pEqwnbTjV11oMQnvNm5JFXsBmSFt9QlxkxNi?= =?us-ascii?Q?YhPP6ZwwSB6lYKnqGs4vLVDSfMnR6VdXt4iZIa1WH4aWoktKCe2ot7jAKIvx?= =?us-ascii?Q?cT X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6a5cf161-accc-4dd7-4055-08d9b68e39a8 X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Dec 2021 18:53:41.6484 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: Ze3LmwqKN7qL+QVnuVfKoVFKr+eutSngTedMLbrHbugwJQEtKZvES1KKnJw7oG0lX7VinB6+WmjFw3thoN69/Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB2759 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10187 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 spamscore=0 adultscore=0 bulkscore=0 malwarescore=0 mlxlogscore=999 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112030120 X-Proofpoint-ORIG-GUID: te_Nk7875gLbDrl3Drah0Xs2rHyOyyh1 X-Proofpoint-GUID: te_Nk7875gLbDrl3Drah0Xs2rHyOyyh1 Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, 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.29 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:280860 Archived-At: > > Is using the Customize UI in the tutorial? > > Is making simple customizations with Lisp > > in the tutorial? Is use of `custom-file' > > in the tutorial? Is use of the `Options' > > menu in the tutorial? >=20 > It's sounds like whataboutism. If you think there > are glaring omissions in topics to be introduced > to new users, let's add them. It's about the relative use/importance. It's not just about whether XYZ might be useful, in the absolute, to add to the basic tutorial. I'd suggest that teaching basic customization should be more useful/important than teaching how to install an external package. But I don't claim to be right about that suggestion. > > Is `load-path', `require', or `load-library' > > introduced in the tutorial? >=20 > Based on my experience with competing editors > (sorry for reducing Emacs to being an editor) > when first starting up the topics of selecting a > theme and installing packages are presented first. > After that, some customization is offered. Some basic customization by users is pretty central to what Emacs is about. "Extensible" etc. in the Emacs description isn't (IMO) primarily about theming or installing packages, let alone deleting installed packages. I haven't checked your changes to the tutorial (mea culpa) - but did you also cover theming? > > How many nowadays _are_ aware of that "main > > feature" but are unaware of how to find and > > change a face or option value? How many are > > unaware of how to _ask Emacs_, to find out > > for themselves about such things? >=20 > That's a trick question due to selection bias. I don't think it is. > Emacs is not easy to learn; if you poll existing > users, they probably figured out how to install > packages. We're talking about first timers, people > that make their first steps in Emacs. Fine. So your argument is that _first timers_ don't know how to install packages and they're dying to know that. They need that, from the get-go. > When these people get stuck, Stuck how? Stuck with how to install a package? That's the question: what's the evidence for this crying need. I see _many_ questions from "first timers" about how to find what face (color, font) is used somewhere, and how to change it. And how to change some variable (e.g. option). I haven't seen a lot of questions about how to install a package. Not at all. Maybe we frequent different Q&A/help venues, or maybe we study/peruse them differently. I don't claim my perception is more accurate or important than yours. But it's you who are proposing the change. > the no. 1 comment they receive is "do the tutorial". I'd agree that such a comment isn't an answer to all first-timer questions or problems. The tutorial should be (or become, if it's not already) a good place to _start_. (Whether it is that, or whether it's the _best_ place to start, could be debated.) Is the need to install packages part of what you need to _start_ using Emacs? Or does that maybe belong in some other tutorial (video, blog...)? > That's where we need to present the Emacs > ontology: windows, frames, undo/redo, modeline, > help-searching Yes, and? > and also package management which is the least > alien part in Emacs. Why also package management? That's my question. Why is that something needed for _starting_ to use Emacs? By "package management" I guess you mean installing and deleting packages? Why is that something you need to learn at the outset? > > The whole discussion (by 3 people) of this > > change has been only about _where_ to add > > this topic - nothing about why to do so, > > or what other changes might be just as > > important or more so. >=20 > Do you want to open up a discussion about how > the tutorial is build, or how to make Emacs > easier for new users? great, but let's start > with something. I posed a question about the need for the particular change to the tutorial that you've proposed - the "why". And yes, "need" as defined relatively - relative to who'll follow the tutorial, and relative to other topics that it could cover. > > Has it been shown that new users _are_ in > > general unaware of packages or unable to > > install them? Aside from questions about > > an early init file or `use-package' syntax > > etc., how many new users just ask "How do > > I install a package?" I don't see that > > come up, myself, on Reddit, StackExchange, > > help-gnu-emacs, etc., and I come across > > dozens (hundreds?), of new-user questions > > every day. >=20 > Fair point. Does it mean we shouldn't try to > anticipate pain points for, say, new users, > and introduce features we think may help them, > unless new users explicitly complain of lack > of such features? How do you propose to know what is most useful to them? We've both referred to questions they and others actually pose. Our perceptions of the relative number that ask about installing & deleting packages differ. But you seem to have even gone beyond that, by saying that real first-timers are unlikely to pose questions about installing & deleting, so relative lack of such questions by them can't be used as a yardstick. In that case, what yardstick do you propose, to support your judgment of this need? > > A good indication of such a need might be > > the number of existing blogs, videos, etc. > > telling users how to install and delete a > > package - and how much they're used. Do > > we have an impression (or tally) of this? > > Is there a crying lack of such help? >=20 > When did any change been introduced to Emacs > due to some contributor seeing blog posts > mentioning such and such aspects of Emacs being > problematic/hard to configure/missing a feature? Sorry, but I don't understand your point or question there. I'm again asking what _you_ look to, as evidence that installing & deleting packages is something that first-timers really need, as part of our learn-by-doing tutorial. You seem to have removed questions by users in various places, as well as blogs, videos, etc., as possible evidence. What's left? From what have you concluded that this is needed in the basic tutorial? Where's the beef?