From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.devel Subject: Re: Emacs Manual under a categorisation scheme Date: Tue, 12 Jul 2022 19:16:35 +0200 Message-ID: References: <83sfn6wb38.fsf@gnu.org> <83pmiaw9aa.fsf@gnu.org> Mime-Version: 1.0 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="16485"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jul 12 19:18:47 2022 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 1oBJX4-00048g-Ry for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 19:18:46 +0200 Original-Received: from localhost ([::1]:40854 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oBJX3-0000Xm-61 for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 13:18:45 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40222) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJV1-0007hN-GC for emacs-devel@gnu.org; Tue, 12 Jul 2022 13:16:39 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:47401) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJUz-0006TS-Hs; Tue, 12 Jul 2022 13:16:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1657646195; bh=Ejd3R56BXmJZsSdDio6EKXGyIZpHyskJQetc8E2Hhro=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=BKmoQKqla54v+svDKpgrQV9+d7FPqw8GaVA7LfWlS0nFOa9FXH0rBgZG3D5cJmsm1 tPIVM5q7Y6vU4CFI68te+xkPih0IGIX5/18pbbbap9K2n+8NaWGY+w2VDBN39Zj8Ws 0wvJvCXvOHR9JDwTG7ngVFIGly50CygBFBZrSKwo= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [92.251.127.164] ([92.251.127.164]) by web-mail.gmx.net (3c-app-mailcom-bs07.server.lan [172.19.170.175]) (via HTTP); Tue, 12 Jul 2022 19:16:35 +0200 Importance: normal Sensitivity: Normal In-Reply-To: <83pmiaw9aa.fsf@gnu.org> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:wUR8Lhs1eH3kb6TsmT+49DrVTWGavkDzLRNIg4yiFhsOsE9Y5VfRG+POb/Yc0cR52ubo2 FPJFvv7KBLPZ5iYTkzRndE7VYYpV0CO2rMaJTdEx6tUp0FtTLFDSZWIY+pSknMkMR/Jbwqj3Gv4/ uQRk1ZT0hzW7KvbUoZ0P5PAe4cm+baDKVc9ZiHk9or74i/Z/DBLc12jK9VxrlbxQRJUTYNUiLtzf v7KbkTzSRs0em+OxbYwk0fNWLv0RW7ioqQW4BPiwLkqqlt0PQUiN12wCJrraqBFTI0lusrwXj/iI EI= X-UI-Out-Filterresults: notjunk:1;V03:K0:J2FNJOHaXn0=:nsbdaVpoPp368mbiEa8U9o 5d0QFG893C6XhWir/FopYJeSwBLhEoAKJHBj2tXCTNYP/he9tCFPrCmiKfRCQPjkuFNQjFuTe 8tdp6ExyN94dTrKXJEzxCteheiqV74BxCbcRIms/jypYFq2deUQJO+XTdpb38Hpt2QUI5xcmN yyxqSZAWPgFYO5OVNsYNQ9XQib3MRVHP4Ea+GyqejZjQO4gqChCrvzzpZr2EtGICSAV5bu0E0 BqyPxaZp7Mn3smgtFjY2cHtKr2ihhrc7r9K0OvHBcusEIgnBfh3G1dfodNXm6AEG98zappv+n JY6WRDXZyrE6hZ9R1G0MiP4zLsO89/vFXLvxtGGa20iIhQ+UHzCqPUENzUZ62rKWRQIcmRJLU uC358bhDKQ4SiLKDJnyzVLxFtlWK2EK1725xVqBPqhi2bN0Sf6DoGNLyThCU1lbRrYPLuMNQX hDUHVEiWeaHewXt2cvvU7WZqkD9q/7N6yujhbF+hTPpAWVzFfzT759mYuTkuqC2b9MeqmtQdE 12RgcV/CxZyXxNhyx74JorTcyO73T7vNtUj5LudNSucaW38AuTKixiTaDiFmecQKVLtHryx+v 2IJR+ZHpOlijz5mD87PIkO3M6szNM0EZ/5qnIIcY6GawoU88COBqdQgnVa2xzsREyK38o+6kq JC358bhr4R/TpYZWGqTb8xZQwruaNJlnF90/HeNQSEB/jxaQeT8G9A1PZUYViWvFIIgOV/Eeg QCDsFPhEK8Md7pA9ojKkCTy3p01/bh2C317fZI9e7xc5A1kbjFVKBjRL4mMTjuSPfT1A/pqE Received-SPF: pass client-ip=212.227.17.22; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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:292093 Archived-At: > Sent: Wednesday, July 13, 2022 at 5:06 AM > From: "Eli Zaretskii" > To: "Christopher Dimech" > Cc: emacs-devel@gnu.org > Subject: Re: Emacs Manual under a categorisation scheme > > > From: Christopher Dimech > > Cc: emacs-devel@gnu.org > > Date: Tue, 12 Jul 2022 18:57:20 +0200 > > > > > I don't think I understand what kind of category system do you have = in > > > mind. Please elaborate and/or show an example. > > > > One could arrange either by difficulty or frequency. > > > > Basically, using a higher level categorisation to the 54 chapters, wit= h each > > high level category being independent of the others. One can then qui= ckly > > skip whole categories one is not interested in, even when using the ma= nual on > > the website. > > > > 1. Comprehending the Graphical Display > > 2. Running Commands (by Name, using Minibuffer read and completion) > > 3. Editing Commands (moving and killing text) > > 4. Using and Controlling the Graphical Display (buffer, window, frame) > > 5. Major and Minor Modes > > 6. Using Help > > 7. Programming and Markup Modes > > 8. Compiling, Testing, and Maintaining Programs > > 9. Running Shell Commands > > 10. Calendar, Diary, Document Viewing > > 10. Web Applications (EWW, Mail) > > 11. Emacs Customisation > > 12. Handling Problems (crashes, reporting bugs) > > I don't see how this is significantly different from the chapters we > have now. You can categorize Emacs in any number of ways, but the one > we have is IMNSHO completely adequate. What you propose is also > adequate (although incomplete, so I cannot easily judge it except as > an example), but I don't see why it is superior. > Yes, it is as an example as I agree it is not complete. It is a higher level categorisation without changing the actual chapters you have now. It was a response on some user comments stating that the whole lot looks overwhelming. You could also make a number of scenarios on what the user wants to search so he can be directed to the relevant information faster.