Perl Docstrings: Put your POD into Heredocs
Python’s docstrings are great, but have no real equivalent in Perl. However, we can make POD sections easily accessible to Perl code by putting the POD into heredocs:
my $some_function_docs = <<'=cut'; =head2 some_function Write documentation here. =cut
This article explains why that works, and how this might be used in your Perl modules.