Problems? Is your data what you think it is? | |
PerlMonks |
Re: Guidelines for listing functions/methods in POD?by Your Mother (Archbishop) |
on Dec 07, 2017 at 21:33 UTC ( [id://1205119]=note: print w/replies, xml ) | Need Help?? |
The major reason the =head2 style came into vogue, you probably had it recommended to you at some point, is that it gives navigation entries on the CPAN sites for documentation page. So, you can click down to a method easily from the top. I disagree that POD semantics should be disregarded and assert that doing it with =item and such is proper. The fault, to me, lies in the presentation layer (CPAN view), not the data (the POD). Up to you which is right for you.
In Section
Seekers of Perl Wisdom
|
|