POD outline for a distribution (you should cherry pick suitable headings and paragraphs) #perl #boilerplate

pod-distribution.pl

package MyDistribution::SomeModule;

1;

__END__

=encoding utf8

=head1 NAME

MyDistribution::SomeModule - Some short description

=head1 SYNOPSIS

  use MyDistribution::SomeModule;

  my $m = MyDistribution::SomeModule->new;

  # hello world!
  say "hello world!";

  # To get a development version up and running
  $ carton install --deployment --cached
  $ carton exec morbo script/irh
  Server available at http://127.0.0.1:3000

=head1 DESCRIPTION

L<MyDistribution::SomeModule> is a bla bla.

=head1 ATTRIBUTES

L<MyDistribution::SomeModule> implements the following attributes.

L<MyDistribution::SomeModule> inherits all attributes from L<Mojo::Base> and
implements the following new ones.

=head2 foo

=head1 METHODS

L<MyDistribution::SomeModule> implements the following methods.

L<MyDistribution::SomeModule> inherits all methods from L<Mojo::Base> and
implements the following new ones.

=head2 bar

=head1 OPERATORS

L<MyDistribution::SomeModule> overloads the following operators.

=head2 bool

  my $bool = !!$cookie;

Always true.

=head2 stringify

  my $str = "$cookie";

Alias for L</"to_string">.

=head1 CREDITS

In alphabetical order:

=over 2

My Name

=back

=head1 COPYRIGHT

Copyright (C) 2017, My Name.

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2017, My Name and others.

This program is free software, you can redistribute it and/or modify it under
the terms of the Artistic License version 2.0.

=head1 SEE ALSO

L<MyDistribution>.

=cut