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: Community improvements to the Emacs Widget Library manual? Date: Sun, 9 Jul 2023 09:02:38 -0300 Message-ID: <739c05a4-7a64-872a-bd5e-972eb8a90346@gmail.com> References: <1e042c59-9baf-ee4f-4726-26aba36847d4@cyberscientist.ca> <83sf9xbqqb.fsf@gnu.org> 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="952"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Cc: emacs-devel@gnu.org To: Eli Zaretskii , Bryce Carson Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jul 09 14:03:36 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 1qIT8Z-000AXl-Nh for ged-emacs-devel@m.gmane-mx.org; Sun, 09 Jul 2023 14:03:35 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qIT7r-0003zQ-2C; Sun, 09 Jul 2023 08:02:52 -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 1qIT7m-0003wg-LK for emacs-devel@gnu.org; Sun, 09 Jul 2023 08:02:46 -0400 Original-Received: from mail-oi1-x22f.google.com ([2607:f8b0:4864:20::22f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qIT7l-0007kT-0Y; Sun, 09 Jul 2023 08:02:46 -0400 Original-Received: by mail-oi1-x22f.google.com with SMTP id 5614622812f47-3a3a8d21208so3235518b6e.0; Sun, 09 Jul 2023 05:02:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1688904161; x=1691496161; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=+cyP83e5iI3aSVtNaw7Te8uXatgW8iqDXNj4hff+rl0=; b=K6CiamVQB3fhtXlXLXwAigqVkioYdAtI24oJ1ih3qAtgzU1MbW+1VR0cuYLqDxizde NZaNVSwlvj2EibV2Aywb4a44sfgpwuuk8KZYXyCvnHnLPPg2tB2UYXUM1LPQlM0Y1Cwi Zge7b/ZMsYnjh4cs1UR2hmSy9Z67tRxGvRt27yFgE3doaM+wVBML/et2TNPAtYKSOg2C ntFywW/srK3rqfOBzdjTTjMORqWaNh6eTDhUtUsV/XspApiwh60rUwyA+FdPEjwKWonh TWFuuw3n9S8y1v0T07hwf4v94UxXJZLkbQAOK/9UnMCMlSrqQjrZbVr/emkB9Ek2pB/R 7ykA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1688904161; x=1691496161; h=content-transfer-encoding:in-reply-to:from:references: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=+cyP83e5iI3aSVtNaw7Te8uXatgW8iqDXNj4hff+rl0=; b=EUIAclAXasiPNoHDjj9RTwvAETZHjqOFqzM2jS8DSby4Ny7roGJ3xb4jfzcfOXpIt+ qOPYTZmAjGWrqnQEhEsXejnIfa5gb6/pUa9NYJdNW1NXRuhUG9Ns3Tyfeq/x/p6fDeBc MKTgbRHkJO8dMbFXnukmVYHaL+IwwNSrT3/el0/yI2SnlqOmP4dozQmEhUSqxyuTVLFd 1A/j1l5DpydXZ/3iMgejJCRRpUMigLc4hZF0GVZ/KhwUH4Bv5fKH6COXjfRnFqY+Gq80 S56ADqQcm0009Lxz1+Z0KjGUW2zzBz25zSgQdPdHAHYJHDrLsJ5Ok4b322DHn/0MK2BB 5rdQ== X-Gm-Message-State: ABy/qLbKWFJEVRq0aNKjdnzjDKmBE48rmXQHTQtkrS1uCx267sDHSXQh t3jjobC404VAx3krgkjyxW3rY/2luNQiYA== X-Google-Smtp-Source: APBJJlEn5W/CnVxTC3yxyc/wa9UiwwYSr9wnEKAFAhrXYpA+FKYnNqDmXZwh6aZhZcoDNtGng64RZQ== X-Received: by 2002:a05:6808:ec6:b0:39e:8bc3:e63a with SMTP id q6-20020a0568080ec600b0039e8bc3e63amr10991487oiv.6.1688904161684; Sun, 09 Jul 2023 05:02:41 -0700 (PDT) Original-Received: from [192.168.0.234] ([186.127.128.249]) by smtp.gmail.com with ESMTPSA id x2-20020a056808144200b003a1f359ba4esm3311365oiv.14.2023.07.09.05.02.40 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 09 Jul 2023 05:02:41 -0700 (PDT) Content-Language: en-US In-Reply-To: <83sf9xbqqb.fsf@gnu.org> Received-SPF: pass client-ip=2607:f8b0:4864:20::22f; envelope-from=maurooaranda@gmail.com; helo=mail-oi1-x22f.google.com X-Spam_score_int: -21 X-Spam_score: -2.2 X-Spam_bar: -- X-Spam_report: (-2.2 / 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=-0.09, RCVD_IN_DNSWL_NONE=-0.0001, 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:307666 Archived-At: Eli Zaretskii writes: >> Date: Sat, 8 Jul 2023 14:18:21 -0600 >> From: Bryce Carson >> >> Would anyone like to collaborate to improve The Emacs Widget Library >> manual? Are there any active >> Emacs Lisp hackers that actually understand this library at a deep level? > > I think Mauro (CC'ed) is our widget expert. Thank you for CCing me, Eli, although I'm pretty sure I'm far from an expert. >> The Emacs Widget Library manual could use a re-write, preferably >> following the Diataxis >> documentation framework if possible. Does anyone want to collaborate >> over the long-term, creating a >> study group and editing the manual to a high standard to benefit the >> community and ourselves? > > I don't think I understand the plan in this aspect.  If important > information is missing from the manual, it can and should be added. > If you want to add tutorial-style sections, that could also be a good > idea, provided that the subject is so complex that reading the main > description is too hard without first reading a tutorial introduction. I think the manual lacks more information about how to do more "advanced" stuff.  It's not hard, but I feel like some ideas about what one can do with widgets only pop up after reading the code. Which of course is really useful, but the manual could do a better job so it isn't as required as of now. That would fall in the category of adding tutorial-style sections, I think.  I'd love to help with that, but I don't have much time available to do it on my own.