Add "clean build and test" as a step in the release manager's guide.

Some of the post-release steps can cause test failures (and hence black
smoke) if not addressed at the time.

diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index d2a6d03..ad4b2d7 100644 (file)
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -931,6 +931,17 @@ Then follow the section L<"Bump the version number"> to bump the version
 in the remaining files and test and commit.
 
 
+=head3 clean build and test
+
+Run a clean build and test to make sure nothing obvious is broken.
+
+In particular, F<Porting/perldelta_template.pod> is intentionally exempted
+from podchecker tests, to avoid false positives about placeholder text.
+However, once it's copied to F<pod/perldelta.pod> the contents can now
+cause test failures. Problems should resolved either by replacing placeholder
+text with correct text, or following the instructions output by
+F<t/porting/podcheck.t> on how to update its exceptions database.
+
 =head3 push commits
 
 Finally, push any commits done above.