Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister

Re: The problem of documenting complex modules.

by saberworks (Curate)
on Jul 06, 2015 at 20:02 UTC ( #1133431=note: print w/replies, xml ) Need Help??

in reply to The problem of documenting complex modules.

I run into this all the time and agree with you on most counts. XML::Compile is one I had a problem getting into. There were tons of docs but nothing that walked through how to do it from start to finish. This was back in 2011 and (with help from the author of the module) I was finally able to get things working, and I did a blog post about it: Using XML::Compile to Output XSD-Compliant XML.

Most of the time, if the documentation is too confusing I just pass and find another module. I had your exact experience with Poe and PDL and never spent sufficient time to learn them. Sometimes I feel like I might be missing out.

  • Comment on Re: The problem of documenting complex modules.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1133431]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others imbibing at the Monastery: (7)
As of 2021-03-04 22:47 GMT
Find Nodes?
    Voting Booth?
    My favorite kind of desktop background is:

    Results (108 votes). Check out past polls.