in reply to Re: seek harsh critique
in thread seek harsh critique
I agree with the SYNOPSIS here.
I prefer a nice short synopsis that has a couple of very short scenarios (although I am guilty of a few longer ones myself for various reasons). I would remove most of the #SECTION pieces out of synopsis and put them into an EXAMPLES section. If you do the POD correctly, your EXAMPLES section will be listed at the top of the page at MetaCPAN, and the sub-sections will be visibly listed, and a link generated to take you directly to that section:
=head1 EXAMPLES =head2 Setting data ... =head2 Getting data ...
|
|---|
| Replies are listed 'Best First'. | |
|---|---|
|
Re^3: seek harsh critique
by coyocanid (Sexton) on Dec 08, 2017 at 20:36 UTC |