Item 84. Check your Pod

Code isn’t the only thing you should test. You also want to ensure that you’ve done the right thing with your embedded documentation (Item 82). Testing your Pod can find many of the documentation mistakes or omissions. Often, Perl programmers include these as part of their “author tests” (Item 88).

Check for proper Pod formatting

Once you write your Pod, you want it to render properly when someone converts it. Hardly anyone reads raw Pod, and most people probably see it converted to text for their terminals, or as HTML.