in reply to Is POD Syntax Obsolete?

Numbered and bullet lists in pod are godawful, but apart from that pod is quite nice, and the =for and =begin commands make it quite extensible. If it's not your cup of tea though, an option is to write in markdown or whatever, and automatically convert to pod for publication.

package Cow { use Moo; has name => (is => 'lazy', default => sub { 'Mooington' }) } say Cow->new->name