Re: Tag certain test methods as being documentation

2020-02-06 Thread Jonathan Gibbons
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

Tag certain test methods as being documentation

2020-02-06 Thread Alain Désilets
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