From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Mauro Aranda Newsgroups: gmane.emacs.devel Subject: Re: [External] : Editions to the Widget Manual Date: Mon, 21 Aug 2023 11:40:18 -0300 Message-ID: <793d512b-b635-3099-56e0-7d9e94d9cbd5@gmail.com> References: <4776bb96-16d4-6d77-d7a8-4fc949070bf5@gmail.com> <10646331-8D57-4760-B940-171EF043657A@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30186"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.13.0 Cc: emacs-devel , Drew Adams To: Yuan Fu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Aug 21 16:40:58 2023 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 1qY65Q-0007Wn-VS for ged-emacs-devel@m.gmane-mx.org; Mon, 21 Aug 2023 16:40:56 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qY64x-0003r4-Fs; Mon, 21 Aug 2023 10:40:27 -0400 Original-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 1qY64v-0003pd-RI for emacs-devel@gnu.org; Mon, 21 Aug 2023 10:40:25 -0400 Original-Received: from mail-oo1-xc2c.google.com ([2607:f8b0:4864:20::c2c]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qY64t-0007D7-OU for emacs-devel@gnu.org; Mon, 21 Aug 2023 10:40:25 -0400 Original-Received: by mail-oo1-xc2c.google.com with SMTP id 006d021491bc7-570d8b31b7eso545125eaf.0 for ; Mon, 21 Aug 2023 07:40:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1692628822; x=1693233622; h=content-transfer-encoding:in-reply-to:from:references:newsgroups:cc :to:content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=Wo4soGXu99PLhLDF5KT10ENPe0FnJx196lyJaltQPI0=; b=FDjEyffyOIs8Ja0IKQLzk0feCuh07JYBcW/FyYRKskqmejciBw4puQtMn0o53SMLZZ VS1xOuqnvimJ9DL47g99Hn0iLsZOs8hUpDfddxvoPlnUDi2RIIYqE2Wl2lqZPQGmlS3+ M51QzAkqve43mDKYQZ1vYZBdqqW+UUnFieQRKGqTpY4N+Bpi1ZTh1YiXPpfzzvkBuqEh AMlAXdkII/sEyaRSoiYtAJzOpaoD2A+3066+6XWuzxWVmGfoS4U4Q2Tu8KJI4l0vEIb8 J29eIlzURIE0w6Rg21kn9Q2BbRrjH1VlMtrJQntQjw+qJ9eVu2IjklMWBx38z5uPDirq AtGw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1692628822; x=1693233622; h=content-transfer-encoding:in-reply-to:from:references:newsgroups:cc :to:content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Wo4soGXu99PLhLDF5KT10ENPe0FnJx196lyJaltQPI0=; b=dx/FGXPuarPsKgATkemLADSOy3Bh1sH+mppRMbhPGT30Zz8NBw1+DpjLCXknnV8uRE UknVm0NQ+9/xj9zltPqTLaVyTkEawKEatPF8mH1l6yFVWNeIxCSBzAZdmJAwJE2VU4Ky bQ776zq2oOyJfcS2qlKRYLg9+AaobjWWFXUru5RvDzsi10yDXEZJXVZI+xVc/8RgpUkc HIxeUYesiNxBryNl5sRWizfyyc8rEVz5r07V9GKTW/9m012S6NFFxdW1kZWA3VcIt+4R QlUK7Lqxz4js+nDnYf8Zc6r/SmxhD3pyM2xi32cWPy5+keJAJhdq/4/16brpD2ZrRnPL KUoQ== X-Gm-Message-State: AOJu0YyeJ4vsEdRCqh74V9G62pqZX3bvVGdQ+d3p2+uY4Jyq4K3OkE1N jXxa/bjXRkqZQzq5kl51b3I= X-Google-Smtp-Source: AGHT+IHRS4PAA+meKSDKE4zPwY8fcNbVaHqgo8jSQprw1PB1H3l+kKlfCIZOa5dkW0V9g4TS3zg+SQ== X-Received: by 2002:a4a:2a53:0:b0:56c:e17e:72ab with SMTP id x19-20020a4a2a53000000b0056ce17e72abmr5613798oox.2.1692628822471; Mon, 21 Aug 2023 07:40:22 -0700 (PDT) Original-Received: from [192.168.0.234] ([152.168.142.156]) by smtp.gmail.com with ESMTPSA id j4-20020a4aab44000000b0056351d2841asm3472266oon.20.2023.08.21.07.40.20 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 21 Aug 2023 07:40:22 -0700 (PDT) Content-Language: en-US Original-Newsgroups: gmane.emacs.devel In-Reply-To: <10646331-8D57-4760-B940-171EF043657A@gmail.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::c2c; envelope-from=maurooaranda@gmail.com; helo=mail-oo1-xc2c.google.com X-Spam_score_int: -54 X-Spam_score: -5.5 X-Spam_bar: ----- X-Spam_report: (-5.5 / 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, NICE_REPLY_A=-3.374, 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.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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:309080 Archived-At: On 20/8/23 20:56, Yuan Fu wrote: > Thanks for working on this Mauro! The overall structure is clearer, > and the additional information is most welcome. I personally think it > might be better to move the default widget to under section 8.1 Basic > types, in its own subsection, so that it’s easier to look for. Thank you for your comments. I can see why it would be better to move the default widget description under Basic types. I'll make that change. > In the same vein, adding some cindexes could further help users to > find the information they are looking for, when using the manual as a > reference. Yes, I left the index and references for the final step, so I can re-read the manual several times to find out what to add. I'll keep working on that.