The documentation I refer to most frequently is the definition of sub activate -- just to remind myself what happens, when.

Yes, the code is meant to be small, directly understandable, and extensible. That's why it's a lot of small methods instead of one humungous subroutine.

That's not a cop-out for not providing better docs. My secret partner is feeding me examples and more tests, and I'm incorporating them in a new release probably in two weeks.