Re: Community improvements to the Emacs Widget Library manual?

[Eli Zaretskii]

> 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.

> 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.
If this is what you mean here, it is, of course, very welcome.  But
the general idea of the existing manual, which is to describe both the
user-facing UI and the Lisp-level reference, is correct, IMO.