Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery

Re^3: Coming up with good examples in POD

by stevieb (Canon)
on Aug 01, 2020 at 18:49 UTC ( #11120204=note: print w/replies, xml ) Need Help??

in reply to Re^2: Coming up with good examples in POD
in thread Coming up with good examples in POD

"I have not written any tests for any of my work yet. I am writing all the POD first, then I will get to the tests, eventually. The last time I looked at the Test suite of modules, I got so confused on their usage, that I just quit trying."

Thing is, if you get all of the POD done, then write tests, what happens if by writing tests you find glaring issues, and you need to modify the public interface? You now have to scour all of your documentation to ensure all examples, usages and explanations get updated as well.

To be honest, I feel that test cases are the best practice for confidence. You get familiar with the process, but it also allows you to have a closer relationship with your code (as you're usually bouncing back and forth from the test and the code).

"It will be especially hard to write tests for the modules I wrote and do not use."

If you don't use them, they are the perfect modules to learn how to write tests against. Nobody else is using them either presumably, so if/when you find glaring bugs and problems, you already know the code isn't in production anywhere. Not so much for writing code for modules already in production.

  • Comment on Re^3: Coming up with good examples in POD

Log In?

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

How do I use this? | Other CB clients
Other Users?
Others rifling through the Monastery: (9)
As of 2021-01-21 17:08 GMT
Find Nodes?
    Voting Booth?