This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlmodstyle: point people to PrePAN, not modules list
authorDavid Golden <dagolden@cpan.org>
Sun, 1 Feb 2015 14:08:58 +0000 (09:08 -0500)
committerDavid Golden <dagolden@cpan.org>
Sun, 1 Feb 2015 14:16:34 +0000 (09:16 -0500)
This harmonizes perlmodstyle with the guidance on PAUSE for getting
feedback.  Having new authors email modules@perl.org is not a good
use of PAUSE admin time.

pod/perlmodstyle.pod

index d6111d0..6f0cb96 100644 (file)
@@ -58,6 +58,10 @@ Do one thing and do it well
 
 Choose an appropriate name
 
+=item *
+
+Get feedback before publishing
+
 =back
 
 =head2 The API
@@ -240,11 +244,18 @@ hierarchy already exists under which you could place your module.
 
 =back
 
-You should contact modules@perl.org to ask them about your module name
-before publishing your module.  You should also try to ask people who 
-are already familiar with the module's application domain and the CPAN
-naming system.  Authors of similar modules, or modules with similar
-names, may be a good place to start.
+=head2 Get feedback before publishing
+
+If you have never uploaded a module to CPAN before (and even if you have),
+you are strongly encouraged to get feedback on L<PrePAN|http://prepan.org>.
+PrePAN is a site dedicated to discussing ideas for CPAN modules with other
+Perl developers and is a great resource for new (and experienced) Perl
+developers.
+
+You should also try to get feedback from people who are already familiar
+with the module's application domain and the CPAN naming system.  Authors
+of similar modules, or modules with similar names, may be a good place to
+start, as are community sites like L<Perl Monks|http://www.perlmonks.org>.
 
 =head1 DESIGNING AND WRITING YOUR MODULE