This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Porting/perldelta_template.pod: Add boiler plate
authorKarl Williamson <khw@cpan.org>
Sun, 11 Jun 2017 14:20:21 +0000 (08:20 -0600)
committerKarl Williamson <khw@cpan.org>
Sun, 11 Jun 2017 14:35:45 +0000 (08:35 -0600)
This adds text about documentation and testing changes, as agreed to in
the thread starting with
http://nntp.perl.org/group/perl.perl5.porters/244582

Porting/perldelta_template.pod

index c84f324..de16646 100644 (file)
@@ -148,10 +148,16 @@ XXX Description of the purpose of the new file here
 
 =head2 Changes to Existing Documentation
 
+We have attempted to update the documentation to reflect the changes
+listed in this document.  If you find any we have missed, send email
+to L<perlbug@perl.org|mailto:perlbug@perl.org>.
+
 XXX Changes which significantly change existing files in F<pod/> go here.
 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 section.
 
+Additionally, the following selected changes have been made:
+
 =head3 L<XXX>
 
 =over 4
@@ -252,6 +258,17 @@ large changes to the testing harness (e.g. when parallel testing was added).
 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
 that they represent may be covered elsewhere.
 
+XXX If there were no significant test changes, say this:
+
+Tests were added and changed to reflect the other additions and changes
+in this release.
+
+XXX If instead there were significant changes, say this:
+
+Tests were added and changed to reflect the other additions and
+changes in this release.  Furthermore, these significant changes were
+made:
+
 [ List each test improvement as a =item entry ]
 
 =over 4