From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Proposal for an improved `help-for-help' Date: Sun, 21 Feb 2021 22:16:54 +0200 Message-ID: <83o8gdw4zt.fsf@gnu.org> References: <838s7hxqkr.fsf@gnu.org> <83v9alw7nu.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25396"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Feb 21 21:21:32 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 1lDvES-0006TS-Cv for ged-emacs-devel@m.gmane-mx.org; Sun, 21 Feb 2021 21:21:32 +0100 Original-Received: from localhost ([::1]:58990 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDvER-00049V-By for ged-emacs-devel@m.gmane-mx.org; Sun, 21 Feb 2021 15:21:31 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38506) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDvAF-0008Qp-Of for emacs-devel@gnu.org; Sun, 21 Feb 2021 15:17:12 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:41000) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDvAD-0005GK-KN; Sun, 21 Feb 2021 15:17:09 -0500 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2729 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lDvAA-0006iR-Jr; Sun, 21 Feb 2021 15:17:08 -0500 In-Reply-To: (message from Stefan Kangas on Sun, 21 Feb 2021 14:04:51 -0600) 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:265440 Archived-At: > From: Stefan Kangas > Date: Sun, 21 Feb 2021 14:04:51 -0600 > Cc: emacs-devel@gnu.org > > > If the order is not the aspect you wanted us to consider, then which > > aspects are? I admit that I didn't give a thought to any other > > aspects yet. > > Well, it is roughly, but only very roughly here, based on an idea to put > more important things higher up. (The thing that makes it "rough" is > that I didn't think through carefully the exact ordering that makes > sense.) This goes for both the sections and the commands themselves. So it _is_ about the order. But then I think we should discuss the underlying principles, and then order the commands accordingly. The rationale for the order in the manual was to show the discovery commands first, and the commands for focused help later. > I think it would be useful also to get feedback on introducing titled > sections, and the overall visual appearance (including coloring the > keybindings). If the aggregation is meaningful, I think having sections should be a no-brainer.