summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2017-06-11 08:20:21 -0600
committerKarl Williamson <khw@cpan.org>2017-06-11 08:35:45 -0600
commit111750baf3b1bd84cd4c00925deb51227ab6064f (patch)
tree6cda3bb50e4a1255771900653905839fba9c3b6d
parentbe99e2c20544013502fa8586131363e94dfa69a3 (diff)
downloadperl-111750baf3b1bd84cd4c00925deb51227ab6064f.tar.gz
Porting/perldelta_template.pod: Add boiler plate
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
-rw-r--r--Porting/perldelta_template.pod17
1 files changed, 17 insertions, 0 deletions
diff --git a/Porting/perldelta_template.pod b/Porting/perldelta_template.pod
index c84f324365..de166467b5 100644
--- a/Porting/perldelta_template.pod
+++ b/Porting/perldelta_template.pod
@@ -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