Alain,
Thank you for your interest.
I'm not sure I understand completely how you use these methods, but I
agree that it is important to ensure that the example code in
documentation comments is valid code. We are looking at ways to
support that, using new tags in some way that refer to exte
One thing I learned about years of programming in Perl is that one of the
best way to document the use of a class is to write a good synopsis for it:
http://blogs.perl.org/users/neilb/2014/07/give-your-modules-a-good-synopsis.html
As pointed out in this blog post, it's important to make sure tha