I'm writing a fairly long document in POD and I realized that I was including notes to myself in the document, even though it's meant for someone else. Those notes would not only distract the person reading the document, but it would also detract from the point of the document. It's long enough, however, that I have to have those notes.
I could keep the notes in a separate document, but I know I won't remember to keep them in synch. Perhaps I could tag them and delete them when I'm done? No, I'll forget to delete one. The answer was so simple, though, that it was staring right at me. I had forgotten about the =for syntax.
=head1 This is another section
=for comment But this won't be displayed
I just mark those notes as comments and use a POD converter as normal. No extra steps to forget about. It's the little touches that I always appreciate.