From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id iE3jHrMIVWTjfAEASxT56A (envelope-from ) for ; Fri, 05 May 2023 15:46:27 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id EDPBHrMIVWSyUwEAauVa8A (envelope-from ) for ; Fri, 05 May 2023 15:46:27 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 85B3A8CC5 for ; Fri, 5 May 2023 15:46:26 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1puvkd-0002bU-TY; Fri, 05 May 2023 09:45:35 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1puvkc-0002b2-0o for emacs-orgmode@gnu.org; Fri, 05 May 2023 09:45:34 -0400 Received: from mx1.riseup.net ([198.252.153.129]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1puvka-0008MA-18 for emacs-orgmode@gnu.org; Fri, 05 May 2023 09:45:33 -0400 Received: from fews01-sea.riseup.net (fews01-sea-pn.riseup.net [10.0.1.109]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx1.riseup.net (Postfix) with ESMTPS id 4QCX4n2l9GzDqBC for ; Fri, 5 May 2023 13:45:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1683294329; bh=VRyhH9WHnVbl1KfNBIXC6GxLyfERI38nGH2aNOzTd7g=; h=Date:From:To:Subject:In-Reply-To:References:From; b=IP8NQv4DdBedpvcv8PuR5E6vmSOvtHt7zPrxzkXlBnZ7USOik3KT0BTNfrvIfhQhc Wp0+FfcTZ3QDmfqhVJHC4DM6M3RZTmAfUXcF8Q2NfaeFfCC2eCzM9MK9eqa4wBFU1D XfvXkyOHi4cBmqZTAyrhlUVfJeorTmrQhlEFD9kI= X-Riseup-User-ID: 5CB3CAA7AAF63A9D57D58DB9F46164BEDFE7A9E7D0247AB1EFA2A8486710824B Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews01-sea.riseup.net (Postfix) with ESMTPSA id 4QCX4n1f43zJqB4 for ; Fri, 5 May 2023 13:45:29 +0000 (UTC) MIME-Version: 1.0 Date: Fri, 05 May 2023 13:45:28 +0000 From: =?UTF-8?Q?Esteban_Ord=C3=B3=C3=B1ez?= To: emacs-orgmode@gnu.org Subject: Re: [POLL] Add command names to key bindings in Org Guide? In-Reply-To: <87y1m3m48g.fsf@localhost> References: <87y1m3m48g.fsf@localhost> Message-ID: <54acdb9e225508581a94b1865f4515c6@riseup.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=198.252.153.129; envelope-from=quiliro@riseup.net; helo=mx1.riseup.net 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_PASS=-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-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Seal: i=1; s=key1; d=yhetil.org; t=1683294387; a=rsa-sha256; cv=none; b=hCZ6D81VY4Y0/AjQKax0q49SqQgxlOZHDuROOtEp14uzWiSoYOlYTe9tb3Upbai5LCbNXP tXzvn4TXbN0Bms3fzTMMqmaSI5B1RPsJ++xl4kvsWDLPdJkY6spKxkEczSdvUwC6JrjNle n79rSdZFGgHUn1xSdFA5eZ/ncQWaqo0j8BY4ERbv+l9W9FEwSQUdElEMD5xIJD9bu/Cd/9 WgtKKfcjw4sl/gHyPtMKLRGIYlu5rXt6kvp90IhHAG5qWkkHZW43yx3LO1Dtl79lECVPCP p+sDmSKea3S2Ei/zVxDSzf+x+lCg5IA8HvVJbWTUPr2nNCIrNua1Qq2LAomCwQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=IP8NQv4D; dmarc=pass (policy=none) header.from=riseup.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1683294387; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=o7LnYPXLXJsZ6c8bGQeCVTiBvnYxZk4wASp3/wWGiVU=; b=EwzJ5sXuvWz5wREjov4C0DAQakEyjG4xKzZ4jDsNxU0WVXBtfJ4mW/ZfLMr1krM3QQ3hcI sRQZdtgN6RiBVsXPD2cY7YoG1pik2zfJKlWyrrgKb9jRtooaF0OlaA6bUrpVYDvVtA9GS9 Ktv2PmWK0xwMy6nN5/PNdBWwTTisPSQ3aK2X352rGoRbdKHeopCCMRPjnsuDJMiARbmvyi 0kQYsbJawqsyp9LMXFm9olOt6RZQy+9gYDXwM0jYf2iJzYGql1U6zw/R2w2x5yatnpePWy jAIN1/lrPACuiL5SUHJxoPssP9d9oD/Cd2EmnpbYGIwluGTVZNl1OxRHDccVpw== X-Migadu-Scanner: scn1.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=IP8NQv4D; dmarc=pass (policy=none) header.from=riseup.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -4.07 X-Spam-Score: -4.07 X-Migadu-Queue-Id: 85B3A8CC5 X-TUID: VkSNLuK3+W+O El 2023-05-05 06:01, Ihor Radchenko escribió: > Yuval Langer writes: > >> For many commands, I find it helpful to first learn their names before >> learning their keybindings. The org-mode guide does not include >> command names. >> >> I want to add command names into the org-mode guide. I have attached >> an example of such an addition. > > Will it be useful? > > Technically, adding the command name will increase the Org Guide size, > which is a bit against its idea of compactness. > > On the other hand, new users may benefit from seeing the command names > alongside with the bindings, especially users of pre-packages Emacs > where the bindings may be shadowed by evil-mode and the likes. > > WDYT? I think that mentioning command names would help a lot to understand the objective of the command and would also help to find its documentation. A common problem for me was [is?] that I could not find the place where there is more information about something. The size of the document is not as important, if it is easy to find your way in it.