Re: Community improvements to the Emacs Widget Library manual?

[Mauro Aranda]

Eli Zaretskii <eliz@gnu.org> writes:

>> Date: Sat, 8 Jul 2023 14:18:21 -0600
>> From: Bryce Carson <bovine@cyberscientist.ca>
>>
>> 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.