I'd make it clearer in the documentation that you can safely access data using $$self for read reasons. Current docs concentrate in setting values, not getting, and I had my hard time to find something corresponding to the suggested ->set() method.

I needed this mainly to build up a private accessor for a member variable. Which leads to a little feature request: would it be possible to automate the creation of private/protected methods? Or, if already present... would it be possible to read it clearly in the docs?