Will apply greater care and logic next time.

Sorry if I came across as dismissive of your problems. Guis in general and Win32::GUI in particular are complex beasts and difficult to get to grips with. To compound matters, Win32::GUI documentation is incomplete in many areas. (See all the TBDs littered around). It also relies a lot upon you either having Win32 pre-existing knowledge of the Win32 gui apis and structures, or you finding your way to the MS Windowing APIs reference material.

It does a pretty good job of hiding the complexities of the underlying APIs, but in doing so, can make it quite hard to relate the MS docs back to the WIn32::GUI wrappers and methods. GUIs (in general) are complex and therefore carry a considerable learning curve. It also means that documenting them is equally hard.

General questions about better documentation are hard to answer (given that it would require someone to a) become expert; b) encapsulate that knowledge in descent prose). However, this place is generally very good at coming up with specific answers to specific questions. Please don't be put off by my inadvertantly dismissive tone. When you have specific questions, please come back and ask them. Even if you don't get direct answers, you will probably get pointers to help you on your way.