It took quite a bit of hunting around the interwebs to figure out how to add a data series to the y2 axis. Could you add that to your documentation on CPAN?
This test case gave me the clue I needed to get the job done.
There is an example in the docs here.
But I take your point. It should be called out more clearly in the main docs.