Suggested standard for component documentation: describe the session structure created by the component, and in particular describe in which session each callback coderef is evaluated. I had some small adventures with PoCo::Server::TCP until I understaoond exactly what session it created and what callbacks were evaled where.
Another suggestion: have standards for passing state down though a component constructor. Perhaps follow the conventions of PoCo::Server::TCP ? Appologies if these are silly, I am just starting to write PoCos. Andy